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ABSTRACT 


The design, develooment and imolementation of a usere- 
Oorientea graohics software system is described. The over-all 
considerations involved in such a design orocessS are dis- 
cussed, alona with the major factors affecting desian deci= 
sions. The object disclay system is a SAMTEK GxX-1CO0OA hosted 
by 3a PUFH1!1/50 comouter. Trmolementation techniaues are also 
presentec. A detailen user's nanual iS aonenced, and recome- 


memmeiatyons for further Syster exoansion are offered. 
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Poet OUET TON 


Design techniques for uservrortented granohics software 
Systems are investicateo. Lae borne 1c) es and techniauyues 
{ 


Qained from this research nave neen anoolied in the implemen- 


maeyom Of Such a system for a PAMTEK Gx-l100A acisplay device. 


Beimary eronasis 15 Olaceqd On Sroviding a user with the 
mimemer!ly constructes software suoport and accompanying cocu- 
Mmemceation tor efficient utilization of the grachics display 
System. The techniques and cecisions involved in performing 


Puen a Gesiqn are discussed in detail. 


Additionally. the Vector General Tanlet was interfaced 
witn the supoort Sytem iS miter tTace Crovidec the user 
with an external EVremsGtlve mnOeVlee er Tor control ot ithe 
Qraphics system. The 301l1lity to interact with the system 


mmeeatliy enhanced the desirability of the over-all] aesian. 


The basic steps 19 the aoolication ocnase were to choose 
a }anaquaae, desian systems fumetionss write a detailed 
user's manual, and imclement ano test the system. The user's 
manual (4pnencix A) Grovides even the inexcerienced Orogram= 
mer with a tool for rapid access to the system. It 1S com-= 
olemented with a tutorial set of examples that more accom- 


eished users riant croceed to immediately. 





The desianed system was implemented in the C orcgram= 
meena lemqueqe ama wmosted by a PDP=-11/50 comcuter in the 


Naval Postaraduate School Computer Lavoratory. 
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iw VeolLen CONSTDERATIUNS 


ice omlowlmom1s oa auote from Drs Eric Carlson of the 

IBM Research Division [14]: 
Bipmtnecwoast,  OROGress wm terminal hardware technolocy 
and araohics software techniques has not bceen accom=- 
panied by Simalar Orocress Wms UnNGerstandi na the 
requirements of the user and anpplicatians of comouter 
Seaenmres 

The desian efforts therefore, in comouter Graphics must de 


Bemried to orovide clarity in man/machine communication. 


The evolutionary orocess of a uSer~oriented svstem must 
mearemme witht ao firm definition of the user. In this context a 
mser 1s defined to be some person or aroup of opdersons who 
desire to utilize some gqgraorics system. Fe, for the most 
Bart, 31S a Nonscomouter scientist who simoly bay Shes tim aac 
Brese1sted cy the computer in the solution of some prorlem. If 
Ne must expend a great deal of effort to learn how to use 
the system pnefore any benefits can be accrued, then the sys 


tem aprears not to ne a tool out just. another hurdle. 


Any conouter system nas the ultimate scurpose of solving 
MOO 'em or set of croolems. tthen a user elects to utilize 
the nower of a comouter system to solve a orobtlem, then unK«ke- 


Nowingly he or she has acded the reaquirenent tnat the oroo-~ 


ie © 








moeeme Statec im two very aAistimet ways. ihe oroellem must on 
Ome hand take ona structure that is amenavle to tne com- 
puter, and on the cther hand be statec clearly and concisely 
to man. As tne user's statement of the problem is decomposed 
to a machineworiented statement of the same orobdlem, the 
interface between the user and the system is critical. The 
ideal interface proviaces a conservational communication or 


Mmeyvmb10sSis’ hetween man and machine. 


The user must be provigeo as many aids as onhysically 
possiole to create an atmosohere that cS ee CO NCU Ci eu o 
Mmmeative thought. Piememexeemes the m™aiority of his effort 
meeemotina to communicate, pow nS vers bvkely te be very 
creative. Thus the manemachine communication must be 


mmmanced in every conceivaole manner. 


The desian effort must, necessarily, beain Wile ot ee a 
Siderations of availanle eauiament. Tf tne eauioment is 
alreagqv in oosition, as 1G was In this endeavor, tne 
gesiaoner Snould strive to interface annprooriate interactive 
tools for a oleasSant communication scheme, These devices, 
mmemohm auite varied, “can be treatea as a physical realiza- 
mom Of one of four virtual devices : the oick, the button, 
Mme locatorr ano the valuator"” tie]. The four virtual deve- 
Mees are defined bdelow: 

wee weole« sls Seq) to cesianate certain of jects. The user 
wil] often neec to point at objects, just a3 a person 


THayesotmt nis *1fqaer to denote a particular olace or 





e(n) (takes 

Pea oe tonmnl Sater oorogrammatic contro] == SSuGm 2S 
Ssncerinausa GCartitcular action from several possible 
actions. (commonly a function keyboarg) 

Geman locator mallows the wser to locate Sscecific points 
Vieni s oe trined Image space. (commonly a tablet, 
joystick, or mouse) 

D. A valuator orovides the cacability to aetermine a 


MParticular value from some definec real space. 


[rus in designina a userr-orienteaq system, certain 
hardware selections/intertace cdacisions must de performed 


Prior to embarking on the software suovort design. 


The cesian of a uservroriented graohics software system 
must orovide the full caoability of the araohics device, 
Satisfv the users and not overload the nrost GOTouUeer. To 
acnieve these acals,r, a toc down aeporoaecn seems most 
appropriate while maintaining a constant focus on user 
requirements. Omen pou ze a SsuccesSsStTul cesicn of a Graphics 
Bemtware System the desianer must choose a suitable impole=- 
Memcation lanauage, crovide adequate software supcort func- 
tions, aeveloo detailed documentation, and finally imolement 


the desian and oerform detailed testing of the packace. 


ivewautnorwt1eS Of comeouter aqrapnics today See two 
Measigle choices for arapnic language selection. A graohics 
language may ve develoced for the soecific device or. an 


existina hiah-level lancuaage, sunpclementegd by a library of 
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SuDrOoUtINes, may be emoloyed. 


The designer who elects to previde a soecial ourpose, 
device dependent lanauege 1S mornally directing his atten- 
Mmons to a Subset of the entire user odooulation. Such a 
lemouaage will often emoloy peculiar constructs while striv- 
ing for increasea effiency. In orevious studies it has heen 
found that the desion ana imolerentation of a special pure 
pose graohics Jlancuage often provices nore of a learning 
exoerjience ee, c[Nemees tannins thae a useful too! to the user. 
Meacidition, the develooment of such a language invariably 
requires a aqreat ceal of expertise in J]anauage structures 
eee ftem SsnowOal!ls into a costly anc time consuming 


OENdeavor.e 


ipemmost Common aoproach to utilizing qraphics eaquis- 
ment 75 to ou1ld around an existing lansuage and generate 
MeelLS to a set cf subroutines resident in some ees eye Tne 
host memcUage muUSt ~trevide the mecessary facilities +» suo= 
port the aporocriate cata structures, and cossess an effi 
Brent suoroutine call cananility. It sucm a lanquade exists 
in the gesign environment, strona consideration shoula be 
Given to employina it as tne vase lanauage for the graphics 


System. 


Having considerec all antions and selected a hase 
Mmieouaege uoon which to build the arachics system, the focal 
Bemmt Of the desian orocess must me shifted to the logical 


mermmulation of the graphical crimitives reauired cv the user 


ey 





seat iom. “1! liam M, Newman and Robert F. Sprou!! fo) 
peofess that “the only aqraphical primitives that the pro-~ 
Qrammer needs are functions ta define ooints, lines and 
MmuEeiay text Strimas’. ITmhesé tasic orimitives certainly oro- 
Mepce the most funcamenta!l set of toolsr but by offering 
selecteaq options to the user a less hostile and more flexi- 


ble system may evolve. 


Ime foumGation, havina meen envisioned and logically 
designed, should, wnen olausiovle, he expanded to provide the 
Meer with a oowerful set of hiah=-level tools. The oairection 
of this expansion 18 necessarily crecinitated oy the ouroose 
meee tme Gracnics system. This mrocessS may provide 93 very 
mermecise set of functions in the desiaqn of special ouroose 
Systems, or a number of BestmmOoniles tec functions which 
emphasize overal | System =2enerality. Each new function 
Spawned by this exnoansion must orovide the user with a new 


and oowerful, vet sinrmcle, tool. 


PoGcumentatien must caralle) the ertire desian crocess. 
Mec al!iVvV important cart of this documentation effort is the 
mreation of a getailec user's manual. This user's manuel 
mmould De virtually complete orior to the imolementation and 
Mesting phase. The desianers have tnus statec how tne ulti~ 


mate system is envisioned. 


mavine reached this olateau, the  imrmolementation and 
Mesting Onase beaginss nut the docurentation effort must con- 


tinue Vine Sieleiime Jie Tn the end, the complete Set On 





meiemimentation etftforts must include a detailed user's manual, 
documented SCG e mC OUe ETC yYMoODpSesS of functions, and =a trace 


of the entire process. 


The implementation and testing phase vpeains with te 
creation of the actual software to ocerform the orocosed 
actions. As this software comes into oceing, detailed testing 


mmiote pe ocerformecd to ensure that it functions as envisioned. 


In summary, the designers must follow some ore- 
Sstablished plan for the develocment of a qranhics Software 
System. [In the acsence of sucn a olan, tt 18 almost Hae c= 
able that the resulting system will fall snort of its expec- 


tations. 
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Cee ee ioeWwaGe SELECTION 


As previously stated tnere are two elausible choices in 
memecting the Jlanquace to support a user-oriented graohics 
eesctem. This choice is driven by the ultimate oureccse of the 
system, time, and mconey. Ine system designers may develop a 
new language tailoresa exclusively for the cevicer or utilize 
mee existing hiagk level lanauage augmented oy a library of 
memctions for contro!) Qt the eevics. kKecardiess of tre 
@eurse of action tne selection should “crovide a language 
Semen 31S Natural, and which does not age to =the Dorecom, 


Mice nrrusctration, and confusion of the user"{le}. 


Ihe environment for the acesign effort associated with 
this work was for the mest nart academic and reauired great 
fMrmexidoility anc generality for tne widely varied user ocrou- 
met 1OMn. The users of the orojyected system would come from 
emer DacKxcarouncs and with an infinite set of requirements for 
the svstem. Due to this need for extreme flexibility a 
Search began to find a suitable high ltevel ltanquage to meet 


the reauirements. 


[iiemeessiovlity of constructing a unique language to 
Support the systen was ruled out almost immediately due to 
Mme time constraint of the effort. Lack of time was cere 


tainly a valia reason in hesoity Duk otner tactors “also 
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deemed this course of sction unfeasible. The goal was flexie- 
bal yt ys and almost always a new lanauagqe oecomes directed 
Momo subset of the user s00ulation. Tne develoved system 
would require on station software maintenance and would 
receive little or no attention if it existed aS 82 New and 


foreiaqn lanauaae. 


Hee Ino made the basic choice to utilize an existing 
hiqh level language the searcn began for an acceptaole ane. 
The Naval Postaraduate Scnool Comouter Landoratorvy hosts the 
Beioment and as sucs its caoabilities ang restrictions were 
considered in detail. Tnere were several lanauaaes commonly 
MamUSe witnin tne confines of tne laboratory (C, Fortran, 
Basic).~The most widely used of all the lanaquages was C a 
and as such research was initiated to ascertain the feasi- 


Memevty of this choice for the oravosead system. 


The C oroaqramming languace was well documented and 
mimpowed the user to write clear and concise prograns. I[t had 
mese contro! cacaoilities making, it a Very readavle 
lanauage,r ana it allowed the user to write coge that is very 
memopact out still clear. Ine language encouraged a modular 
mesiaon ana orovided alt ole Cheon Mmeecessary constructs to 
imolement a viaole «Granonics system. The fact that the 
language was commonly used cy oersonne!] involved in research 
Within the confines of the laboratory was another plus-7 for 
Memeecting it for this aoalication. The feeling was that the 


Ceprogrammina tanauage would sunoort a comoletely flexible 


eo 





BmGeageneral Ouroose aqraonics systen, thus the aqee ys ion to 
imolement the system with Le as tne base proaramming 


language was made. 


A software supoort scackage existed for the RAMTEK [13] 
at rhe onset of this research effort, but its configuration 
Mes Unacceotable basec on tne research to this soint. From 
previous studies it was learned that a high level langquaae 
empoorted bv 3 library of functions was the most commnon 
meeroach to utilizing a aranhics device. The existing 
software supoort oackaae did not resemble this basic aesign 
philosoohy, as it existed as two very large dlocks of cbject 
code. Feqardless of the size or needs cf the user program 
these two blocks of code were merely aonended to the con- 
mea Orogram resulting 1n a very Waeges, execution mocule, 
This imolementation tecnniaue was found to oe completely 


[meeotisfactory from 3 desian standpoint. 


Havina decided to use the C orogramming lanauage and 
realizina Dare neome x Str aOesertware SUOpOort S$ Organization 
was not 1n comoliance with the orescrihbed goals, the next 
meee wes to develop the structure and organization cf a set 
Memeo rary suosort functions to oroviae for soecific support 
of tne device. 4 detailea analysis of the existing system 
was initiated. Tne system was found to orovide the basic 
cacabilities and moaular desian that was felt would be 
requirea. The decision was made to base tne new supoort sys- 


memeom the C orogram™1ng lanauage elus a library of rudimen=- 
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meamyerumctions securead from the previous software supoort 


system. 


Prior to emoarking on the fase or SeSUNIdime -<suen —e 
ineorary r the UNIX ooeratina system constraints were invesi= 
meted to reveal the sropoer |ioOrary structure. This environ- 
mentally imsosed structure was a major concern as the 
develoement orecess tcegan. The reason that no orevious 
attemots hac oeen mace to orovide tne envisioned structure 
mMeaeetmat it was to oe quite tedious ard oossioly require a 
@mest deal of redesign. In the UNIX environment tne Jidrary 
memesearched sequentially from start to finish to resolve any 


undefined references from tne conpilation of a user program. 


Pais linear search oroceaqure emoloyed cy the host SSS 
tem dictates that the library nave a very precise structure 
Mamet 61S «©6tOlCUbDe efficient. As the liobrary searcn 1s performed 
memeeceferences bv internal functions must ne forward to cirs= 
Cumvent the necessity of multiole searches of the same 
morary. Failure to organize tne library around this very 
mao constraint coula result in very inefficient utiliza= 
mon . Fo usOnGagitze the  fucimentary liorary in such a way 


Meaquired indeotn studv af the existing software. 


moemexistima software Suocert package was studiea in 
detail to determine, without exception, tne pcrecise funce 
mmomina of each module. [t was paramount to explicitly learn 
the patn of Manet wemmcal ls  tror eacsy of the existina pro- 


meerersl fUNCtIONS. This information was found to he best 


IY 





gGeemereqd i” tabular format. 


A table of cross-references for each function was con 
eeructec. This table ultimately diseplayeao the calling 
Seauence for each function and what functions called it. 
This organizational steno orovided the imsight reauired to 
Meeinm to organize the library. Rad the original desiaqn 
employed a library in the language decision orocess vice two 
large "programs" tnis steo could have been eliminatea fron 
moro cesigm. The fact that the new user-oriented desian wil] 
be in a lidrary will facilitate more efficient Software 
maintenance and sianificantly reduce the size of the user's 


mec ition module. 


lee me x1Sstima Gackace was written in the C€ programming 
language and, as such, fitted the proecosed lanauage imcele- 
mentation technique cuite well. The structure having been 
exnmosed, the task was to build a fundamental suprort libvrary 
from oreviously develcoed software. Tne functions were 
mee ther researcned to seek out which variacles were used by 
Seem function. This orocess was nost involvece bdut neces- 
Sary, as the environment of UNIX allowed for only sinaqular 


mat i1alization of each variable. 


peor cantzat icone | Cima rt nas aGevelorec to ascertain 
where ang when initialization of eacn variaole was to take 
Peace. Unce the varianles haa been laid out nea a loo ea | 
mat yalization seauence, the wacctval bSurldina erocess could 


be embarked upon. The concectual design could re seen as a 


ie 





feasible task, Ou te ama. exoli1c}t layout o f the proposed 
library had to be mace ana manually verified. The structure, 
Mormmoe efficient, had to oossess no oOackward references and 


memoayvide for sinaular initialization of all variables. 


The base library was desiqned and imcolemented. After 
detailed testing it became apoarent that tne new concert 
performned better than the old even though there were no phy- 
sical improvements to the software functions themselves. The 
library provided much smaller execution modules, as only the 
user=requested functions were aprended, not the entire pack- 
age as was previously the case. This newly structured 
mmmmony ss 21SO oOoSssessed the benefit of ease of maintenance 
and exnansion. This represented a major step in the overall] 


@mee) of the croject. 


The first steo in the design cf a usertoriented caraph- 
i¢cS system hag been accomolisned. An existing language sure 
Bereed OY a liorary of Subroutines had been chosen for 
imolementation of the system. Had this step teen cerforned 
In the original investigation a more viable and maintainable 
Peeocem would have existed from which to ceoart. It was felt 
Mmm tn1s structure orovided maximum flexibility, efficiency 
Smee created a firn oase from which to oroceea toward a 


userworiented system. 
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ieee veoteMrOr oa, otE“M FUNCTIONS 


fiveumtrema meth] cevelooment of graehics software sys=- 
tems 18 toward hiane-level SOEs e eSuO@Cort tockaqes that 
orovide simole,y oowerful controls over the caradilities o f 
the system, yet shelter the orogramrmer from the low-level 
features of the hardware. The desian of the functions” that 
make uo these software cackanes Olays a vital oart 1n deter 


murring the success or failure of the system as a whole. 


ineethe 8mvironment aiscussed Herer the basic machine- 
level interface (tne "“driver") ovetween the nost computer and 
the graphics odisolay sevice had seen installed. In addition, 
peemumoer of software routines had been written for the sys- 
meme !here® was mo orsanizecd library of system functions. 
Instead, all of the written routines hag been conglomerated 
Mee two files, inclucina avery large samole program. Tne 
requirement to coring ootnr of these larae files into memory 
Mmeneevery mroaram's execution was consicgerea unaccectaole by 


esteabliishea desiam standaross. 


me was Ceciftea et this coint that the most realistic 
Seeerogch would oe to modularize the existing functions, 
@eeamnize them into a cronverly formatted library Structure, 
ang thoroughly analyze this packaae for content and funce- 


meena: capability. [The desian and develooment of this system 
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MmioGary was G@iscussed in “LANGUAGE SELECTION". 


The ensuing analysis of existing routines revealed many 
shortcomings” that peQuirea either modifications to the 
Beercting code or a ccmrolete redesign of that oarticular 
Mme C7 ON « In adaition, the software oackage as a oe See 
mot offer tne user the ful! capabilities of tne system as 
envisioned by the aesianers. As well as not providing the 
full capability of the aevicer the system was severely lack= 
mae im interactive tocls. The system did not orovide suffi- 
@epemt Contro! ana communication facilities for the user. 
Numerous additiona) functions were desiaqned, createdr ana 


imolemented for this ouroose. 


This onase of the HecVomeeeGcOcess 2 waS not 4° ~ourely 
meet ive exercise. [t was a case of the cesigners overlayina 
mm@emexisting software with a “temolate’ or "mola" of the 
System they envisioneds tnen moaifyingr restructurings and 
mmeamdina the existing package to fit this mold. Tne system 
memctions that evolved from this “modifiea" desian process 


ome oresented in detail in the User's “anual (CAocendix A). 


mime raeclusion of an increased interactive cacahility 
Involved the lec ica! design and creation of avenues to 
Meiitate amore symbiotic man=macnine communication sys- 
tem. The only external stevice availaole to the user was the 
Bevyboard. A basic Grachics system can survive with only this 


caoability, SMS MOwlCmmot Oa restrictea to this Gevice wnen 


mre Gossidbility for exDansion Arcs tS. ny econecertea effort 


fa 





then began to pProvige the user with a flexiole communication 


medium. This medium was the Vector beneral Data Tablet. 


Me Oo tact nS Yat eractive tool to its fullest, tne 
Moeent was to Give this one ohysical device tne canmability 
Bomeroear as four virtual MeviyGes (Sek, Button, locator, 
m—eprator). Ine pick and locator functions could ce satisfied 
via a tablet ariven cursor. This caoabilitv became one of 
mmemcdoals of the software desian. The tablet could also ful- 
Mmmmiethe valuator function orovided it could take on vari- 
able dimensions, aNnG ive the user the anilitv to select 
merdies from within this soace. Finallysr the tablet ccula be 
bok en into user-definec switches that could respond as Dut 


Mmemoor FUACtTION Switches for orogrammatic control. 


By logically envisionina the tablet as discussed above, 
Me Provided a nice comolement to the RAMTEK keyhoard. The 
user, NOW Ravina twa interactive devices at nis disposal, 
would enjoy a more flexiole communication interface witn tne 


machine. 


B cross~=sectional view of tne software support Sac kace 
momo reveal a structure of "tiered conolexity”. At the base 
Mummmts structure would lie the oasic ocrimitives for a 
graphics system's overation. Some of these routines are only 
one step removed from rachine lanaquadgae instructions. These 
mmumitives form the founagation for higher level function 
develooment, but must also te made accessinle to the more 


advanced users' Srocramrs . The next level in the structure 





wemombe COmorised of more definitive graphics applications 
Mipetioenms. “ost users could accompl)ish al! their desired 
work at this software level, but Teer would likely) =requi1 re 
numerous and reovetitive calls to these functions. The 
high-level functions that form the crest of this structure 
are directly supoorted ov the first two levels. These are 
the furctions that offer the user more oowerful, oroblem=~ 


erented ootions. 


MmpGeas@eGct @t tmree levels of Graduated potentiga) was 
meev1ed to e@ach of the functional areas or control modes of 
Memes er A“MTEK GQurino this cesian/evaluation ehase. This was 
mumso the anproach used to ensure that the full range of 
color maniculation cacabdilities were availaole to the user. 
Thus as SaGin basic hardware caoability was investigated, the 
associated software to exoloit that capability was logically 
@esigned and concesctuallvy aligqnea with this structure. I[f 
Mmewexisting software did not conform to this view or did 
mie) C Rime on r cote enyiswoned soeci fications for that par- 
ticular machine cavability, it was modified and/or exranded 


momGoO so. 


Most of the modifications that were requireo were to 
Memetions of tne first and second jevels. For instance, tne 
procedure for selectina a oaerticular color entry (trons the 
Sempeont color table) was ocoorlvy implemented. This function 
had to be comoletely redaesianec to achieve thre proper 


results. Myke wySe, Che reutine that existed for tne ourpose 
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Mmpectoolishina a Starting coint for generating any display 
felgeemot taken into account certain control mode/control fiagq 
combinations trat require more than one machinew-level 
ies cruction to initialize the proper registers. Minor 
corrections or imorovements were made to numerous other 
fmome tions tiene firSttwo strata of the design structure, 
primarily in the areas of manoing virtual screen acdresses 


memmreal screen locaticnSr and cerforming error checks. 


ihe majoritv of new functions that were cesigned and 
Meereeed during this erocess were hiaqh=level functions aimed 
at improving overw-al! system performance. Puring the evalua- 
Mmem of the color disclay techniques, it was recognized that 
muse r could smend a areat deal of time In generating tne 
exact colors he desirea for a oarticular aisplays yet he nad 
memway of Saving these color caombdinations for subsequent 
use, since the svstem color tatles are automatically ini- 
Mmarized upon each new access to the device. This forced the 
user to regenerate ris colors at Sach session on the ecuio-s 
meme =—- a time consuming task. This cananility of oreserving 
userwradefined colors netween intermittent sessions was viewed 
Bean aosolute necessity. Thus two new fume t Vons were 
developed : one to conoy the status of current color tables 
ImcOo a file in the user's Sirectoryr ana one to subsequently 
restore these colors nacx into the system tactles after ini- 


meee) zation has taken olace. 
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Another capability that was found lackina, and was 
therefore generated cdurina this onaser was the avdility to 
simultaneously display multiole alonanumeric character 
strings, Suchweaseebocks of text. This function relieves the 
tieer of the distracting task of making repeated cal!ls to the 


mid-level single strina disnolav function. 


By application area, the laraest number of newly- 
introduced facilities were ij we ne realm of GrOovIdimne an 
interactive caoadility between the KAMTEK disclay system and 
a Vector General Tablet. Anproximately fifteen functions 
were desianed in the afore-mentioned tiereaq structure to 
Geter the user a wide variety of interactive techniques. 
fame tablet may thus be used for nanioulating or aenerating 
Smee ta0les;, Girecting the movenent of a software-~aqenerated 
@eesOor on the disolay screens selecting proaqrar execution 
Seevons from aisimenu of ltoaical taolet Switches; ors with 
emeoer acplication of tower-level functions, ESKeOCE Mircea 2A ta 


Meese lay onto the screen. 


maemmagitied desiaqn aoorosach that was taken, ba weeeeliel atc 
me tion with the tiered=srtructure view of the software, 
Proved highly efficient ny oreventing the loss or waste of 
any previously aevelooen functions, while readily identify-> 


mummmamy lack of functional cacanility in a carticular area. 


mmemenvyiSionec system and the newly introduced caocatil- 
1t1ies, in order to Orovige a truly uSerrorientea environ= 


ment, required a continuous reflection on the user and ais 
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eevenologica| pehavior. The user's basic esycnolog) cat 
Beauirements are time aependent (17). The user exnects cer- 
tain responses in a scecific time frame or he Ddecomes’ frus- 
Meeted and displeased with tne system. Each scecific funce 
Mmmer was evaluateaqc for vossibdle unfavoratle psychological 


hmeolOnses. 


[he psychological make-up of the user was of prime 
importance in the actual Gesamte me anmterectuve color 
memo lation routine tabdcolor(). This function allows the 
user to interactively modify and/or create system color 
tables. The excectations and vossidle frustrations of the 


user were researcned in detail in this regard. 


Imus tne USer was recognized to Aave certain expecta- 
tions (17), ana a concerted effort was made to ensure that 
the system could adequately meet these excectations. The 
@emoeting oronerties of efficiency ana simolicityvy remained 
fundamental considerations throughout the develcomental oroe 


Ges sS « 


“em Cessibple, the system furctions were designed Se) 
emeoy i interaction by anticioation"tiS]). This aoproacn 
decreased the reauirec numoer Ot Silacnest1¢ messaaes and 


mera result ina more satisfied user. 


PeIistactorcy fesconse times were sliso consicered in the 
over-all system dgdesian. It was found that users could become 


Meet rateo and annoyec ty tne imeorooer timnina of resconses. 
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For example, when a user performs unaGorrectly, i las 
shoula not respond immediatelys but delay from two 
seconds. l!his delay allows for psychological closure 
Mees Ss Dart, after which time an error indication 


accentable. 


The logical gaesicn of system functions thus 


system 
to Tour 
on tne 


iS more 


involved 


validation of existing software, desian of new software, and 


Moenstant reflection on the user's osvcholoaical needs. 





Ve. DOCUMENTATION 


ieee cumemtetlon etfort wm this tmesis work was a con=- 
memuous Process that oarsalileled all other onases of the oro- 
meee the tack of sufficient prior documentation was con- 
Sidered aS one of the motivatina factors behind this work. 
ies Geficit was certainly one of the major hindrances 1A 
Sertrorming the object syster design. JTherefore, the formule- 
meom Of Crooer documentation for this software system, on 
Serticulear a wellw-conceived user's manual, was of utmost 


importance to tne desiaqners. 


An attempt wasS mader tnrougrout Ene Ces 1an7eVvalueat) on 
orocess, Gio’ recora every or Tokers aol; every result, every 
achievement, no matter how Dire Sal le cian 1t Mirae have 
seemed at the time. Tnese notes, Bote. Se cminely unorgan- 


ized, served as valuatle reflections during tne imolementea> 


tion and testing phase, as well as when this writing bveqan. 


Mimwes the Ultimate coal of this thesis to develon a 
maximally user-oriented araohics software sysStem accomoanied 
Dy an eaually use@rroriented user's manual. Without the 
latter, tie miOonties avcuildg Surely GO Unrecoonized and unused. 
Mem this 1m mind, a creat deal of thouaqnt Sem reor erst om 


Mere devoted to develcoina such a manual. 
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The resulting manual (CAnrnendix A) 1$ organized along 
MET ollrOowWimer limes. First there 1S an introaguction to the 
basic systen environment and to the manual itself. Next 18S a4 
guided tour of the steos required to gain access to this 
environment. This is followed by a tutorial review of tne 
basic orogrammina «novwleacne a user should fossess to 
aporoach this system with some degree of confiaence. “The 
next cnapter actually beains to reveal some of the features 
et the graonics cisolay system, and exooses the oasic rroe- 
GQrammatic control functions the user will need. The remain= 
ing chaoters (Cexceot the last) are each devoted to one orar- 
Mecular functional EomeOll Wey nOonD control mode of this sys- 
meme I AIS will, hopefully, orovide a nore systematic revela- 
more of the over\=al!l capabilities and features of the 


display system. 


As each of these areas 1s exoloredc, the associatec sys- 
tem mMimGtitons are oresented 1% 8 too-down fashion. After an 
mero duction to the nasic acclication arear the hianwlevel 
miieetions are introcuced first, follcowec by croaressively 
memwer level functions. This aocroach was taken in an attenpt 
meomegllieviate the difficulties of tne novice user in aaining 


fmemrlijarity witn tne systenr,. 


bare chaoter of the manual is devoted Lom cach o f the 
orimary interactive day ices s the RAMTEK keyooard ana the 
meerer General Tablet. Tne final chaocter oresents routines 


wich S( 2 ine ig eile imueorolmoare of amy OCacticular functional 
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mpeap and had thus not been introduced earlier, but whieh 


mane orove useful 1n some acolications. 


Perm imdivyrOual system functi90Nns, in the UNIX format 
[6], are included as Anrendix 8 for further clarification 
emev7or review by the user. In additions, a cony of the source 
Mege for each of these functions (with exolanatory comments) 


mamevailable in the Naval Postaraduate School Laboratory. 
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Mee [VPLEMENTATION AND TESTING 


Beer REFERRED TECHNIGLE 


iaiea | lye the iTiellememrat yon oN ase "or ee CGomouter system 
meeron. should only account for 25-304 of the total effort. 
The functional desian is comolete and a detailed users 
manual exists for the orooosed system. Actual imeclementation 
mmeuwld then consist of codina, deouccing, and localized 


maot ina. 


[re cocina effort should offer little challenge, as each 
mome@tyon has been laid out in aetail. It shoulda be merely a 
translation of ideas ioe suit aoere MNedium for the —com- 
puter. the decougaing of each fumetion affords more of 6 
emeallenge, as without fai! logic errors will exist mm the 


@eocic desian. 


As the deougaing erocess heqins the documentation must 
Mmememkeot current or in tne end tne documents will not accu- 
momely depict the system as it actually performs. Liar cocu= 
mentation and reality ever neain to diverge then an unten- 
Pemmer situation is likely to Fe createc, tn the form of an 


unmaintainable system. 


As fumctions are brougnt on-line, local testing will ode 


@eemoucted <-~ local testina beina those tests cerformned by 
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the oerson responsible for a oarticular functions ismolemen= 
tation. tiem eereOolemamwithetm)s local testing 1s that often 
mremctestor 1S too close to the problem to orovigqe a good 
test. After the local testing 18 comoleter the cetailed 


maatimqg of the function should be performed. 


This detailed testing should be oerformed by some cerson 
Smee trerably some grcup of cersons who have no stake in the 
eimeeess or failure of the system. Ideally this testing wil] 
be done by a team which woulao soena as much time and effort 
developing the test clan as went Into the design. Al) cate Xe 
eemem this last microscoocic testing 1S omitted, with the end 
result being a system eu) oO f Poe lex t assumptions and 


emiporises for tne unsuspecting user. 


meee CODIFIED TECHRIWVJE 


lpxe creferred techniaue could not Ser Mabel yeCc >” te this 
Paemort 8nd was thus moarfied to meet certain restrictions 
and needs. HNooefully the end result was the same -- leaving 
a viable and truly uSerworientea system. The reasons for the 
modifications were that a test team for the thesis was 
Sime siysticr and that an existing system afforded a point of 


@emartUure in search of tre user=orientedc svstem,. 
le oe nie Um Ger pe VAT TON 


Due te the fact that a software supoort package was 


already ia existence Goimanestins  |ENMthis Moai fication was 
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injected. It amounted to having three chases veing performed 
simultaneously. Tne three onases were FUNCTION DESIGN, DOCU- 


Mere prATiON, ano TESTING. 


mime woperatingd to Oarallel, as Oroocosead functional 
requirements were enumerated, the existing software and its 
associated dcocumentation were searched to determine if such 
a function already existed. If the existina system possessed 
mem a function tren the validation/conaemnation cfrocess 


beqan. 


Tnis orocess was fundarmental, as 1t eitner valiaatea 
meee performance of the function or it caused it to be con- 
Bemmaed. Ihe orocesss though simole conceptuallys was one of 
the most difficult and time consuming stages of the systems 
evolution. If the function perforned exactly "as adver- 
Mise ad’, then the acticn was to merely document and continue. 
When the function dia not act as exnoected, tnen the often 


lengthy ana involves search beaan for tne sometimes illhlusive 


meaic error. 


The neec for this unrewaraing exoerience was Tost 
certainly created py tnadeaquate testing of the previous sys- 
tem. This inageauate testing had also causea the "old" svs- 
tem to fall erey to idleness, as users do not relish tne 


miemant Of usSinae a svstem full of frustration and surorise. 
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Celie were | ae LON 


The fundamental suoccort functions of the predecessor 
to this userworiented system had been installed and tested 
Brior to the start of the implementation pnase of the moci- 
fied aprroacn. The volume of change was small when viewed 
goainst the entire system, but essential in a truly user 


Srpiented system. 


The actual cocing effort of the selected adaitions 
to the now deoendable pase system only accounted for acorox= 
mracely 10% of the total effort. This ohase was actually 
Semoucted exactly as discussed in the PREFESRED TECHNIQUE 
Mmetmyorm. Once the codings deducaina, and localized testing 


was completer then detailea system testing began. 
iS: . VET ATEERS TESTING 


fmemeetanritec testing of the overall system was con= 
Mmered in comeliance with the creferred technique. Ine use 
of an external testing source was not feasiole,r thus these 
suagestions were nent Sanat y te aceomogate theo cirs 


Gumstances of the design. 


The dual thesis effort afforaed a vianle test via 
oscillation of duties vetween aesigners. The person resfcon=- 
sible for the actual jimolementation of a VUimMe trom Was menor 
Meteonsidble for it's tasting. Thus the desiaqner's counter= 
part became tne gevil's advocate durina the formal test 


phase. 
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Deseo erontec tne formal testina,s, user testing was 
not only encouraged but souaht. Tne systems, when possible, 
was made available to users == requestina that they convey 
their likes and dislikes, successes and failures. The syso 
tem, having oveen designed for the users was then evaluated 
[mye critically frem user comments. For the most part 
response was favorable. “Aihen unfavorable responses occurred 
they were studied, anc every attemot was made to restructure 


MeeteonaASOeCtS that were found to be distastefu!. 


Pee CUNTINUED TESTING 


P™eOrGeretonr a system to ceally claim to oboe user-= 
oriented, Mais t Ce Olaces) im i Continual test posture. 
fms Continuel testing 1s informal but allows for response 
Mmeomeuser criticism. PpemESer WwSeattorced tne facility for 
voicing nis Problems with the system. These user assessed 
Pmoolems must de evaluated and acted upon. The action need 
perme De drastic, Was saayvrscegd — SyStem moedificaticn, Sut an 
honest Pecrmrat st nes = OFoolem. If corrective actions are in 
order, then the documentation and software must be modified 


foaeemnison. 


emer tek "Gx=|0UR Graphics suDocort system 1s 
Currently listo lles ana umMgeragoina ithe continued testing 
Ohase. There are no known proole s,s, cut the facility for 
Mommemnag SUCH oroblems exists in the form of a trouble report 


attached to the device. 





Vii. RECOMMENDATIONS 


lites SYStem, as C€CCntiagured, 


tive develoomental environment. 


ment wills, hopefully, encourage fresh 


Should now offer 3 


innovative research 


Sroauc= 


ns mewly Created ‘enyiron= 


in 


fea apelications of color graphics. Two such areas surface 
Ermo s t immediately as lixely canaiaates for meaningful 
research. These two areas are: 

COMMAND, CONTROL, AND COMMUNICATION; ana 


Soria PROCESSING. 


fme Command, control, and 


are bounaed by imagination alone, as 


evolving. The 


one mrethe tront~runners in the 


tems. 


momererful tool in tnis recara. 


mimrred signe! crrocessina 


been performed on Cie Cey 1 ce. Tne 


Smeourage more use of color in this area. 


ramereemost certainly convey nore useful 


ieeradoition to the new aoclications, 


ié 


Comnumicat lor 
this 1 1e1 ao 


TMC Ot NCOP RMUter Graohics wii | 


arom ie at 1Om-sS 


New 


ape l1est ions 
eee a | 


most surely be 


ieoreremtation Of SUCH sys= 


[emco Or veamaolvlities of the RAMTEK should orovide 3 


have already 


system shoul ec 


ae eo lor aso lay 


Tereecrat 10m. 


it would oe rene 


mie ia) the saving of comolete screen inages were cossi- 
Sueee Ihe memory space required for fir ies Som 1cat or would 
require serious €ansideration Gut Coil a spe arranaeo to 
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permit efficient utilization. The memory readback interface 
moc mot installea on this equipment, out with its installa- 
tion ana minor software efforts ieewould be possible to 
memorize screen imaces. This memorization process coula 
eliminate the need for repetitive orocessing while oroviding 


pmoowerful tool for the user. 


The support liovrary exists as a seovarate entity and is 
maeeraced via the € ecroarammina lanauage. Possible researcn 
MEMe’ GaDability to sccess this liorary via other |anauages 


would te a worthy exoerience. 


' 


fhe ever continuing maintenance of this and all af the 
Systems is of the utmost inoortance. Similar efforts as con- 
ducted on the RA“TEK coulda oe undertaken for other arapics 


devices in the laboratory. 





Weel Ore ot ONS 


An existing software support oackage was disassembled, 
mrem restructured, tested, and expanded into a usable color 
Sieaehics aisolay svstem. The goal, as a user-oriented sys- 
tem, was achieveds out the Mest anueporoachn amd the solutions 
to problems encountered offered tne real lessons In this 
learning process. These were the nost imnoortant results to 


Mee desianers. 


MeececesiGmima a software system based on a orior 
designs POS ce Gio sc1 ole to mave e€0/20 Hindsitaht imto the 
failures of the orevicus attemot. The most orafound judge- 
ment deriveo is that detailed olanning rust orecede i1mole- 
Mmemcatiton efforts. The parent System that SOawnec this 
Moeer=oriented child was not clanned tn aetail nor well docu- 
memred. Had the steos utilized in develooing this new design 


been emoloyea Vqmene —oRevious effort, there would orcbad!l y 


Mave oveen mo need for major revision and exhaustive testing. 


Ihe system has oeen facta! led. “amc tested. Adequate 
documentation has oveen oroviged to assist users 1n the effi- 


meemt use of the device. 
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Pee ei XA 


USERS MANUAL RAMTEX GX=-100A 


This manual 1s cesigned to provide the users of the RAMTEK 
Graphics display device 3 convientient and sintole introduce 
mmbeom to the oevice. fhe manusl allows for as detailed an in- 


Mesmraation into the system as the user desires. 
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‘a INTRODUCTION 


The RAMTEK GXel900GA graohics display system utilizes a 
meeeer scan technique, with the disolay image data being ex- 
tracted from an internal refresh memory. The RAMTEK system 
Mae the Nave! Postgraduate Schoo! Computer Laboratory is 
Memmeecg py a POP=-11759 comeuter and is accessed throuch this 
computer, ana its UNIX operating system, from one of the 


terminals in tne Lao. 


mals) mot the Imtemt of this manual to orcvice a de-= 
taileaq analysis of the hardware or internal functicns of the 
RAMTEK device, cut rather to excose the user to tne Software 
support packaae that has bopeen agevelocead UGhr \itoe This 
Pemeeware Cackage consistS Orimarily of a system library of 
mmemmoutines Written in tne ‘'C° prodqramning lanauace. Includ- 
Pema this liorary are a number of routines that ensole the 
Moers to i interface the RAMTEK with the Vector General Data 


moet in the Lab. 


A review of the Table of Corternts would = reveal tne 
meme Organization cof this manual to eve as cescribed nere. 
Following this Introduction is a chapter devoted to  fami- 
Mrerizing the user with the environment in which this araph- 
1¢S SyStem exists. Tne next chaoter oresents the funuvamen- 


tel procramming knowledae required of a prospective user. 


us 





memtowino tCmis, tne basic control functions of this system 
are described. Next the user 1S i1ntroducedqd to the data ta- 
blet interfacing routines, followed by color manipulation 
techniques. After this, there are eiart chacters that each 
describe one of the cortrol moaes of the Gx=-100A. Then cores 
empemanpter detailima the use of the interactive keyooara. Tne 
final chapter discusses the remainacer of the software sup- 
wort package. Ahere aceoropriate, the separate chaoters are 
mvrded into three sections : Introauction, basic User 


Guidelines, ana Advanced Methods. 


The manual will serve as a tutorial on tne suktroutines 
available to the user fer generatina displays on the RAMTEK 
terminal. There are numerous samole programs included to ale 
low the user to crecome familiar with operating the system 
and to exhibit certain features that are available in the 
RAMTEK software supfort oackace. These sanple programs, 
alona with several laraer cermonstration oregramsr have been 
compiled Tmt ome soecial directory in the host computer file 
System (see Operating Instructions). The user is encouraged 
to execute each of these samples as he proaresses through 


Pals manual. 


morethe UuSer that requires @ nore detailed knowledge of 
the internal fUNEtTIoning of the device, tne PAMTEK GxX-100A 


meeocramming “Manual {1] is available in the Lab. 





Black & White 


Conrac ° 


| ON/OFF 


Brightness 





FL tURE | 





ee OP erAT ENG INSTRUCT I Ows 


Peer AMiEK dnsolsey Geyvyice is accessed via the "A" since 
See ii750 in the Comeuter Lab hy using one of the ternrminals 
menmected to this computer. If the user 1s not familiar with 
mmemoperation of these terminalss he should consult the Ter- 


meme User's Manual {c} available in the Lab. 


Meeeoraer to utilize the RAMTEK, the device must be 
Beewercd=on” and sucported by the POP=-11/50 computer. By 
following the ie steps listen below, tne user will ensure 
himself of a successful session with the equipment. 

meeensure the "A" sige PUP=11 comouter 18 in operation. 

SE@e sire coubt, check with Lab staff.) 

Pmetneck the green ocower supoly licght/switch (markead 
MRAPITEK POVEP"”) at the lower rear of the host PDPell. 
meen s switenm 1S NO 41 liimimated, contact one of the 
Lab personne! for assistance. Indiscriminate use of 
mors SWitch will cause the host system to "crash". 

$3. Apply power to the RAMTEK kevboara and monitor : 

wenememecmes PUvER Switch om the wooer right ocr- 
Pilopmmo metme  Keyboara should te 1)luminated, 1 f 
mOt, deoress tne switch. 

Sees e CGCmune. UN “DOS 1t1om of tne selector xnob at 
the lower left corner of the color disclay moni- 


iopmemcoee Fig. 1) 
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c. (optional) select the "ON" position of the power 
Hu von onm tne = lower fromt Oanel of the black & 
white monitor (See Fig. 1) 

Gee vootiomalsJ seleet the ON" position of the cower 
Switch on the Vector General Data JTanlet. 


PEG noOoOSsSe one of the “A” side terninals and turn it on. 


Peet mys COIMt, the user 18 ready to log into the UHIX 
aperatina system ana groceed with the session. The user that 
[/ereemas CO execute one or more cf the sample erograms’ from 
this manual or view one of the RAMTEK demonstration orograms 
smomla continue with steo 5. For the user that has been es- 
tablished in the system with Miessown Veen t i )lcatyon ang 
Muepectory, the most common activity 1s orocgcram development 
S@leeetestina. This user 18 assumed to Fe familiar with the 
Seenratinag environment and is referred to Chapter IV, Pro- 
Grammatic Control of the RAKTEK. TRe user with only mocerate 
Peoeemryence in the UNIX environment may wish to scan Chapter 
III, Rasic Proaqramming Reauirements, tefore proceecing to 
Bmeoter IV. These users may return to step 10 below for 
terminatior oOrocedures. 

Beet the selected terminal, the comoletion of the  fol- 
lowtna sequence will lead tne user to the system 
directory that contains the samole and cemonStration 
orograms (mote $: lower-case tyse imcelies a user-tyced 


command, uoperscase tyoe denotes a systen reoly, leas 


momche UNIX promet signal, and "c/r" means ceoress the 


—etuRN key) * 


G7 





O- 


LOGIN: ¢cs2000 Cua 

PASSWORD: student G7 

Bea ramt ek CIT 
To determine what source ecrograms are available *£for 
inspection, the user should tyoe : 

les AC crr 
Pose will result In a2 listing of the nares of al!) 
melecemim the escUUG/ramtek directory that are of tyoe 
meee as ihiis lyst of file names will apecear on the ter- 
minal screen. [PRe files strat ore normed o1.6¢ tarouoh 
o20.c are samole scrograms tnat are descrived later in 
Gero manual. The other files listed are of no concern 
Mom tne user at this time. 
To inspect one these files, the user should tyoe : 

Wet =e fi lename.c Gre 

Gy 
where "filename" denotes the nare of the scarticular 
emosen file. (tmemesecone (ang suosequent) "“carri ace 
merudrm will cause the naxt "sage" of source coce to 
be orinted or the terminal screen. For examples to 
mesmect the source code of the first samnlie proqram, 
the user would type : 

Mist. =¢ pil<c ¢/r 
To execute one cf the samole oroqrams and view the 
mesmulting cGisolay on the RAMTEK, the user should type: 

fi lename.x ae Al 


peere. filename” i$ the name of the selected sample 
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program. 


After decoressina the RETUR’ 


KEY, tne user 


should turn his attention to the disnlay screen. 


Im additicn to the samole 


there are alse fouide 


csc000/ramtek directorv. A 


these demo orcarams can tre 


Manual" fel. 


GCroaqrams, the user should 


ram Cre 


Subsequent demo oroacrams are callea 


ram4. These deno oroarams 


rey to 


faclet. 


After comoleting the desired work 


user should croceed to sten 10 for 


moe ror the uSer who 


SeeatimGg or nodifying ea f 


meectoOory), care must 


additions/corrections are 


eeam.e Ihis 1S accomolished cy 
w filename Co 

inven typing : 
a Cyr 

will get the user out of the 

mit) 

Mee iO terminate the session on 

eitiliek eal a 
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oroarams 
demonstration 


detailed 


coffer the 


interact witn the R4MTEK keyboard 


1s currently 


oe tatcen 


incorporated 


mentioned above, 


Sarograms ra tre 


exGisomat 1oOn o f 


foune 19° tue User Emtry 


Femivilewemenie star st sot these demonstration 


Fyoe : 


ramc, ram, and 


user tre oopportun= 


ana the data 


fOr One session, tne 


termination crocedures. 


editine 32 file Cie, 


jew ime) Se OunTOr ‘ace tas s 


ro ensure the latest 


Into N36 ecro- 


EyOUVURG at the terminal = 


“eor1t mode. Cecemre hac. 


D 


feo Leroi one iss tv 


Lod 





Peeloe Soveredowm “the RAM“TEK, the following steos 
smould be accomolished : 

aos Geoer ee themaGmeen cover Switch on tne RAMTEK 
Keyboard by depressing tne switcn. 

pele lcetmtne Or —DOSIition of the selector knob 
at the lower left EGQrmen Of therco lor 6)sp lay 
monitor 

Tene loc Geet Cee mMonttor 15 On, select the 
Witt “Ses ttiom wor 1tS Dower Switch om the lower 
front eanel. 

Gd. If the Vector Genera! Taclet was being used, 


Seleectutneom Chr  “maoSTtionm of 1tS DOWwer Switch. 
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Powe oC PRO GPAMMITG REQUIREMENTS 


In order to utilize the RAMTER disolay device the user 
must have access to the comouter laboratory and a login name 
mameese UNIX time sharing system. fhe fact that the user 1s 
established in the UNIX operating system allocates the srace 
reauirea for eroaram ceveloonent . There are two Secarate 
Bee= 11/50 comouters in the laboratory and thev are referred 
eee mc mB Sides. The “5 sidé@ hosts the grephics 


Side 1s usec for 


eo oe 


mpspiay devices of the laboratorye the ‘Ss 
@emera! orograr develocment. In order for a user to effec- 
tively utilize the svstem he snoulad have access to both 
Pemerers. « «'his allows the uSer to create ard debusc proarams on 


momen & Site, then execute the oroarams on the "4" siae. 


Tne C orocramming lanauage (3) was used to develon the 
Pmeeware suOcort for the PA“FEK and, as such, the user wil] 
be required to orosram in C in orager to VAC e rT ace ath this 
software. Pewee agedage 15 similar to FURTRAN ot orovrdes 
pmeemeat deal more flexibility. A C mrogram consists of data 
M@eemrarations and one or more ftinctions. This language has 
five fundamental data tyoes: 

Mat Cintecger) 
char (nyte) 


meats (single orecisicon filosating ooint) 


acmimlemiageubole crecision tloatinac soint) 
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reaister (Same as int exceot in a register) 
Declarations may be made internally or externally, with 
Mespect to a functions ieee demagre) ther local or aqloba) 
scope respectively. Global scone imolies that the variable 
memeenmown to all functions that follows local scone implies 
that only the function that contains the declaration has 


knowledge of that variatle. 


peerumect1om GORSISts of a set of statements enclosed 1n 
braces Gyommeveryuc Crogran muUSt Contain a function called 
Pmaiver” since execution of aC oreaqram becins with the first 
Statement of SNE ee Sieetunmet poms must be exclicitiy de= 
mbeeecO (Including “nain") oy a statement of the form ; 
mometion=namelootional araquments). Tne optional arguments 
are the wav that data are communicated oetween functions. 
The arguments must ce enclosea in carenthesis and, even if 
Memerguments exist, the carenthesis must alwavs be oresent. 
[jem statements within a funetion are always terminatea with 
a semi-colon ands, aS oreviously state, Pie 8D Odv., “65 2 tne 


meaction MoMPCReGTOSeGC in Seraces. “ain will mormally invoke 
emer functions to oerform certain Gactos, tits 1S accome- 
olished by Stating the function name followed by the araqu- 


meee 7 St and terminated ov a semi=colon. 


Beeem tChiS very cursory okelre Eyre Ene wee orCOodremmi AG 
lanquage the user should ne anole to understand the example 


meeonrans of this manual and write simnole C osrograms. The 


Beee~eeis @€ncouraged to reaq the C tutorial (4) and the C€ 





wererence manta! [3] for 3 more detailed description of rhe 


language. 


It 1S assumea here that the user has some knowledge of 
the UNIX onmeratinag system, at least to the level of having 
@eoa the "UNIX for SBeqinners”™ tutorial (Sl). Thus ne will 
understand that files may be created by invokina tne UNIX 
meer EDITOR, giving the command to sopend information to the 
file, fmserting the alse oMpiurslte evel) terminating the agcoend 
mode, ang writing the file. Tne followina short exercise 


should refresh the users memory. 


LOGIN: “user login name" G7E 
PASSWORD: “user oassword” Cyr 
ed samole.c c/r Cravoresi text seaitor } 
3 Gar (enter aopoend mode) 
maim) Gyr 
Wigtmaro, total » Gr 
a=17 b= 2, Err 
Coes! = a + tC, Gr 
ave SUmr 1S 400, t ota! ); One 
} ey rT 
; C7T 
N ey (write file) 
q Calle (cunts edit mode } 


mmmseexample creates a file COMO rocran) called Samole.c 
Eheat, MmemMercomolledg anc executed, sumS two intecer values a 


mmemmor into total and then orints the result. 





The user should recal! that in order £O  comol le a C 


Meegranm ne must invo<e the C compiler by using the “cc” com- 
mand. To comoile the above examole the user woulda tye : 
ec sample.c Cyr 

The result of a C compile is an executable file named a.out. 
Moe file 15 created if one does not already exist or re- 
Biaces the ola aeout file if one existed previously. In oro=- 
er to save an old a.out file the user may rename it bv utile- 
meemperetnme UNIX fumetion “mv'. For the user to save the ga.out 


mmmer created by comor1rling samole.c he could tyoe !: my a.out 


mmore c/r . this cnanges the nate of a.out to samole. 


Meayving oeen refreshea on the very basics cf the C ecro~ 
Qramming lancuaae, Gril XxX» SRE EC OMeT ation Orocecures, the 
oes ready to begin writings, compilingr and executing 
programs Sccammica tyme (or tne MAWTER Graonhics disolay deéev- 
Mees Ine user-cesicnec orograms [OG stne RAMTEK wid be 
decencent upon tne RAMTEK software sunoort library. Tnis lie 
Bimeony contains a multitude of user oriented routines that 
Seerow Him to oerforn certain tasks on the aevice. These 
routines are actually C functions and in order to invoke one 
the user must only mention it's name. Since this suoport 
Boemrine 1S mot within the user aefined C orogram, it is un- 
Semmes unless a link iS orovided to the succort library. 
Mom ink 15 Orovided via a shell commana callea "“ramtek". 
igiemin order to comotle a oroaram that references functians 
Semeaired im the Jlicraryr the user tyoes : 


pamtek f1lename.<.c Csr 
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This wi)! issue a “cc™"™ command with the approwvriate parame- 
ters to link to the software supoort liorary anda resolve tne 
oreviously undefined function calls. The following examole 


typifies this orocedure: 


LOGIN: "loaqin name" C7 er 
PASSwORD: “user eassword" ors 
eq C15.c © ip 
a Vay 
main() Ee (s 

{ramtek(); erase), CrcT 


@rvsca ls); C7 ct 


} C7 
: Gyr 
W Cy 
q ec 


moamwec ChS.c c/r 
feemeresult of tne anove example Will oe tne creation of a 
Mmm~emeci>.c (the scurce code) ant an a.out file (the execut= 


mole file). 


As creviously statean the user, for efficiency reasons, 
moma create and comoile his programs on the “B" side of 
Mmmemelanoratory facilities. If the user has followed this 
Quideline he now has an executable orogram that will display 
Some colors and text on the PAYTEK screen (the user should 
Meee Concerned with how this 18 done, but merely with the 
Procedure), but the executable orogram 1S on the "5" side 


eo the "A" SuiseomeGumally hosts the oranhnics disolay deve- 


a0 





ices. The user must then transoort his executable proaram 


from the "BR" side to tne "A" side. 


miomtramsaortatlon Of Information from the to lee: 


meee side may be accomplished by using the system functions 
meme and “get". In order for the user to transfer the 
Pot file created from the compilation of CIS.¢ he must: 
(l)be logged in on both sides simultaneously 
We) from thre “8S” side tvce 
Ses ce Out C7 ir 
Mehe —syoctem will respond DUNE when the action is 
comolete) 
(3) from the "A" side tyoe 
Get a.out ¢c/r 
(the systen will respond with DONE when finished) 
Now the a.out file createa earlier resides on botn sides of 
Meee la0oratory’s POF 11/50 comouters. The user is also 
mmeead 1% On both sides and should logout of the "B" side in 
consideration of other users. The user may now execute 15 
Brocram and see the RAMTEK response. Prior to execution the 
user shoulo ensure that the Gxel0DOA 1s Dowered-on according 
Momeeme first three steos tn the chapter titlea OPERATING I[h- 
STRUCTIONS. For the user to now execute the program he must 
Mees 2-0Ut c/r . [ne RAMNTEK should resoona with a diselay 
of assorted colors and alphanumeric data on the screen ana 


mm@emeterminal should resrcond with the % promot. 


So 





hme user may also use [MP() and EXP() (see UNIX opro- 
grammers manual [6]) for tne transportation of information. 
These routines orovidge two way communication but have cere 


tain restrictions that make them a second choice. 


The user, havina followeo the CI5.c examole to comple- 
tionr now has two copies of the same file. Une file 1s on 
meee a’ side and the other file is on the “83" siae. This du- 
plication of code is a waste of snmace ard as such the user 
should remove one of tne cocies. This removal can oe accem- 


olished oy using the system routine AT elev oe (Ri) acOUlt  C/ Ff) 


imiewtuser 1S mow creoared to move into the srecifics or 
the RAMTEK succort oackage. For more detailea infermation on 
C, UNIX, and the use of system terminals, refer to the 30° 


Pmemriate document in the laboratory. 
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Poona Te eCONTRUL ORI HE RAMTEK 


A. Opening the Device 


lie re 1S one liOrary sSstbroutine that MUST be called in 
Byery program that apolies to the RAMTEK, and it must also 
memecrve first such subroutine called. This routines anoropri-~ 
ately named "“ramtex", ovens the aevice and estadlisnes user 
meeess to ite This will also clear the screen (and the re- 
fresh memery) of any prior aisolav. The call may anpear as 
follows : 

ramtek(); 

As mentioned nere, this nust be the first RAMTEK subroutine 
call moe the iuser’sS procaram. iiss routine will Return 3s 
value of negative one (-1) if unatle to oven the device, 
mumerwise it returns a zero value. Tne return of a neaative 
memoer tO indicate an error concition 18 common oractice in 
this system and its ooeratina environment. The user should 
@emsult Apcencix 6 to find the orocer Cciagqnostic information 


meme ach FOUtine in the software supoort packaae. 
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B. Virtual Screen Dimensions 


iMnorder to develoo functional crogqrams for apolication 
to the RAMTEK, the user must be aware of the concect of the 
"virtual" screens which means the user's view of the screen 
wilt differ from the rea! hardware configuration. The 
display screen may be thouant of as being made uc of 249 
horizontal lines, each consisting of 640 elements. (Each 


eee rs.) In reality, 


mepeveienent comoination 1s called a 
mars Oevice has Sid raster lines. Due to certain interfacing 
Pestrictions it has veen madified to allow only 480 of these 
lines to be visiole. Tne otner 32 lines exist off the cottom 
of the screen and are of 19 concern to the user excerpt when 
the "scroll" routine is emeploved. (see Snecial Applications 
Bomeynes", Chac XVI). All other display routines in the Suee- 
port packaqe map the user's addresses onto the 480 visible 
lines. Since this GxX-10045 accesses these visible lines in 
pairs rather than individually, the result is e400 adaoress- 
able lines. Thus the initial view of the screen could ode 
that Peo NOvecUUearyasWwith the cocredinates (0,9) In tne 
meer ieft corner and the coordinates (640,240) in the lower 
meee corner. Ihis 1s NOT the view that is used when operat- 


[meoetnrough the RAMTEK support packace. 


The software succort ROuUU TmeS weave oceen designed ~te 
transform the screen into the more conventional "Cartesian" 
mmmemeoattern that has its minimum values in the lower left 


corner and ts maximun™ values 1n the uccer riaht corner. 
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Thus the user views 38 viftual Screen as described by an or- 


dinary Cartesian grid system. 


Pt should be noteo here that the initializing "“ramtek" 
routine dimensions the virtual screen to 100 X 100, with the 
Mower left corner representing the point (0.0,9.0) and the 


meeer riahnt corner (100.0,100.0). 


By utilizing the routine callea "screen" the user may 
dimension the virtual diseclay screen to any desired size, as 
momeas the coordinates conform to the conventional pattern. 
mmeewcal! is of tne form 3 

screen (xm™inszynineg xmMaxr ymax); 
where the parameters are real numbers that represent the 
minimum and maximum ranaes for the conventional Cartesian 
coordinates. After dimensioning the screen to the desired 
Size, the user may rely uoon the software suoocort packaaqde to 
memvert any set of cocrdinates that are valid for that arid 
System into the proner real screen location. (see "conve" 


meme COnVI' in Chapter <VI-r Seecial Aoclications Routines) 


fee ictual Screen Aaccressinoa 


The user has now cefined the address space for the vir- 
Meee screen, and may choose the coint from which the disclay 
meena OeGine Inis involves the location of the Current 
Operating Bocanto@emmmue- jr lime COP 46 initiatly located at 
Memerower left corner of tre screen. This is the case after 


every call Hem Dem SGreenm  Geutine. & mew location for tne 
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Beremay be eStablishea by using the "“strtxy" routine and 

passinag aS carameters the virtual x,y coordinates of the 

feared starting point. This call] should ove of the form : 
Strtxy(xry); 

where x and y are real numbers. The COP is modified by most 

of the actual disolay routines, as exolained in eM eaueer 


chapters of this manual. Therefore the user must confirm its 


meet ion prior to attemotina to disolay another image. 


There are three modes of adaoressine tne RANTEK screen ; 

pmeolute, relativer and indexed. 

1. Abosolute addressing is the normal OG Ce out Sa nece:. 
[ine startinaq ooint (COP) for a Aisplay 1 selected by 
mo woretme strtxy' froutine. Ine ending COP denoends on 
the currént control] Mogdeemtuhan Vil = xIV), and tne 
Bvoe Gt display that 1S Generated. 

2. Relative addressing is only acolicanle to the craphe- 
Mes GContro! moces. [ts only tse 1s through the routine 
called "nointr". Tne real nmnumoers cassed as carameters 
Meee fointr are summed with the x and y values of the 
last COP to derive the next COP. This allows the user 
to generate such displays as a sequence of vectors 
drawn relative to each otner, wWeneuwt ComouttaG tne 
memeual Ssereen ceordinates of all the end points. AS an 
examole, if the COP was located at (10.0-,10.0) and the 
user 1Ssueqd the command 

Sorgtr (See, —-5.0)4 


maeomew COP would ne located at (Se Uipes 6.0). |e g the 
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Userewas cOerastima im the Grandhic Vector mode, the 
above call nOuUlG | Nave —earawn a vector from virtual 
PACE Connten ded, lO.0) to coint (15.0,5.0). 
Inoexed addressing 18 turned on and off oy use of the 
bamidie x routine. A call of the form 
index(i,sx,r,y)? 

where 1 has the inteaer value 1, would initiate ine 
dexed addressinc. 41] sundseaquent instructions would be 
interoreted aith resoect to the x and yy parameter 
modes in that call. Ihis address maoccing 1$ gone boy 
SuUMMINQ any subsequent screen address with these 
Vaiues to determime a new COF. For exameie, if the 
following subroutine calls were issued 

jimeex (heres, ec. 0), 

Sitin cc (oe pom o ) - 
mneewcUr woul@ be located afr the virtual screen coorci- 
nates Geer ar re Oe). This adagressina schere can te eme- 
ployea in any of tne control] moces. Indexed adcressing 
1g terminated by issuing ancther index(lis,x,y) call, 
with the oarameter 1 having a value cf zerc. Ine this 


@ese, the x anc y Darameters are tanorecd. 


OU. Control Modes and Flaas 

Programmatic control of the Gx-100A gcisolay device ine 
mepeves | «6Selecting one of eiaht control modes. Each of these 
modes is affected oy €2G6qg1@ CcOomtro! fleas. A Separate 
Mmeaerer in this manual Vomeevaned. to each of the contro! 





pemmece A cescrigntion cf the five control flaas is oresented 


here. 
Ix = Indexed Addressing 


The effect of indexed addressing 1S explained above se 
Virtual Screen Agaressinga, AChR Aten oCaTSeCUuSS1On (Of 105 


meer ollina routine called “index”. 
BK = Keverse SBackcround 


When set, this causes 3 "raverse polarity" in tne color 
Peemect1onm process. It effectively reverses or inverts the 
current color table. The areas of tne screen that were being 
Semwm im color entry 0 {normal backaqround color) will be re- 
Merced to color entry 15- and vice-versa. (see Chao VI, 
menor Uisolays) [ator logs. Ws turReo ee and off by tne 
Bokepnad routine. The flag woulda be turned ON if the parame- 
memo Was given the value | in the following call : 

ol laren oye a 


Memo was Given a zero value the flaq woula oe turned OFF. 
aie Additive Arite 


When set, the generated image 1s combinec with the imaace 
meepeady being ercjectet at a oarticular location. This may 
Be used to combine cnaracters into special characters, 
create overlay tvyvp2 daqdisclays, or disolay some cnaracter 
@lose to another image without gestreying a portion of tina € 


image with the seven by twelve cixel matrix useag in disclay= 


63 





Mermemearomamumeric characters. (see Chao. VII, Alphanumeric 
Mode) the control af this flag is accomolished by the "wrie 
ton" routine. As before, if the single parameter is al the 
mag 61S SUcmeGgumenms, )* 1 1S U0 the flea 18S turned off. The 
cal] should aopear as follows : 

Wet COM tw) s 


mere w reoresents either 0 or 1. (See Acpendix B for error 


diagnostics) 
Dw = Double width 


When set, the imace beina disolayed 1s goubled in width 
Peom itS normal S$1z2e; ie, where one element was deina 
"painted" two consecutive elements on that line are 
Poeomrayed in the selected color. The desired character size 
(normal or double width) mav be selected by using the "size" 
procedure as follows :; 

size(s); 
where $s 1S either l or er representing normal or double wide 


Beompectively. (See 4nocendix & for error diagnostics) 
FP =- Fixed Point 


When set, this causes the (next) established COP to oben 
Seme the common starting ooint for all subsequent end points 
issued jn Graphic TC GonmeonGrm ©1100 (Gemeratiom. (see the 
mmeameers On araphics moages) The fixed ooint flaa is turned 
Memoma OTt by the routine named "fixot". This single=- 


Parameter y Uigheenice ts accepts Sitnereaa tere tte turn. off the 
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muceeor a one (to turn on the flaq). The call would be of 


meme form ; 
fiat Ct)? 


where f is either 0 or 1. (See Ancnendix 8 for error diagnos- 


tics) 


The association of these flaqs with the different modes 
memeeshownm below in a listina that tndicates which flags are 
effective in each mode. fiote the number assigned to each 
mode, as tnese numcers are used 1n imclementing these modes 


Beemomerstion on the FRAMTEK., 
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a i ee eee 


Mode Control Flags 


No. Name IT xX Sk AW Di FP 
") Alohanumeric Weor Teo 8 YES YES NO 
1 Transverse Data MEO Yeo YEO YES NO 
e Raster Data MES Veo wes YES NO 
3 Complex Data WES S NiO et eo NO 
4 Graphic Vector Weeoo. YY GS NO OL ee © 
5) Emaonic Flot CES VES NQ Nae) es 
6 Graohic Cartesian Eos TES NO NO NO 
ri Graphic Element VES CES NO Rue NO 
The control modes are selected oy use of the "setmode" 


routine. This routine requires two parameters, tre first ber 
iamrne Mumoer of the desired node as indicated above. The 
Second Parameter must ode either 0 or 1. If zero is oassed 
pummecontro! flags sre turned off. If one is passed the con- 
EEO | flags are left in the state they were in ecrior to this 
meee the call is of the form ; 
setmode(a,bn); 
wmpere 3a 1S an intecer value (1 = 7 and b is either 0 or 1. 


(See Acpendix F for error diaanostics) 





VeneeveEetOmeGeNERAL OATS TABLET INTERFACE 


The Vector General data tablet is an electronic device 
which allows the user to sample the coordinates of its 
mae t=tike surface (aoorox 17" by 17"). The tablet is lo- 
cated in the Laboratory and is hosted ov the "A" side 


pee=t1750 corputer. 


fms tamnlet 315 interfacea to the RAMTEK software suo- 
Bert routines to provide the user with a valuable Interac- 
mmeewtoo!l. fo effectively utilize tne data tablet, the user 
meote become familiar with it's onmeration. The following 
steps will eer CAE Giemt any ior iaoe won Oorocess ; 
(1) Locate the cata taolet (for assistance see the 
Sieieit f)\ 
Ce eligwemcmero -Orm switch located om the box con= 
necteqd to the tablet surface. To use the tablet 
the switch must oe Cl; when not in use the switch 
snouheae pe OFF. 
(3) Locate the stylus (a penslike device connected 
Dome cumescomtroller oy a wire). Un the stytus there 
imc eCren tio. that Tay be decressed. The 
SeemesovOmmor this tio 15 Sitanificant in certain 
apolications. 
(4) Atso naticer on the tablet eaaer that there 


BReomeOMmNE TY amts, One light indicates that tne 
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Stylus 1S near the tablet Surface and the other 
indicates that the plunger is depressed. 
Cae tirmeonm the tablet and witness the MUG t 4Oins 


Strtnemscy1us ama the Feactions of the lights. 


The data tablet interface allows the user to i1nterac- 
tively control the execution sequence of his program. To 
effectively utilize this tool, the user snould be aware of 
what the software Suocort routines, desianed for the tablet, 
can do for him. There are seven software supcort routines of 
interest to tne user. Seat enactive tCucorial program 1s 
proviaed for the user's convenience. ThiS psrogram exercises 
Sach of the software sunoport routines to give the user a 
Meelis tor what they can do. To uSe the tutorial the user 
Myeestat one of the "A" side terminals) ; 

POGINewesceUU) 6/7 Fr 
Passer DS student c/r 
ea ramtek €7r 


VG Oe xu 67°C 


Imes sequence of stecs is for the user who 1S not al- 
ready loaged in to UNIX. If alreaav loqged in, tne user need 
memey cntance to the “"ramtek" directory, then execute the tuo 
Rommel! orogram. This would be accomolisned by tysing 3 

Cemvusre7esevU0/ramtek clr 


Viet a O7. * ey p 


me ejyther case the result wil! ve that the fc or ia! 


Soaran wil! be aetiwvacec. lt exercises each of the funce 
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tional routines in the supomort oackage. Users are encouraged 
mmewalik through’ this session prior to attempting to enaaae 
the sevarate tablet routines. At the comoletion of the ses-= 


Memerethne UNIX cromot (4) will apoear on the terminal. 


For reference ourcoses and for tne user who only needs 
to be refresned on ene TuUme trons Or the FCablet suprcart 
routines a brief gescriotion of each 18 Srovided. The fol- 


lowing iS a Synoosis cf the routines included in the ocacxade 


Cl)tabinir() : Ocens the tablet and sets the max- 
imUmomumcer of switches to 2S. 

Ce wtandlmetxamax,t xmiM, tymax,tymin) 26 6 ows Sehe 
user to define his own view of the tablet by stat- 
imeGutae mTax’rTUum ano mninmimum values of his co- 
ordinate system. 

wccmay (ny eomeeturms tne x and y co-ordinates of 
a ooint on the tablet, as defined by the location 
Steer memsceylUs. ine anaument “n"” allows the user to 
select whether or not the tin neeg be depressed 
(n=1 oen rust ce qdeoressec, n=0 pen not 
deoressed). 

(4Q)sixoak() : Defines and allows selection fram a 
Susana Set of Six logicel Switches on the 
tablet.(see temolate ! in Lao) 

Gs olds wlocwy, <higxlo,yhizsvlo)} +; Allows the user 
Sommeou Gun ts Owm |16201Cal Switch at a tocation de- 


fined by the users inout and assians the users 
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Srecteenunger lSsw) to it. 

Sap Gcetswlseseneturms the number of the valid ltogi- 
cal switch in which the stylus has been deoressed 
Sewers! tt invalid. 

(7)tanswns) 3: Allows the user to define logical 
Saumwenes Evia the feblet 1tself by cicking the low 
Baa aga OGOlmtsS Of each Switcn with tre sty fuss 
The number of switches cesired 18 indicated by the 


B ] 


Oarameter "ns". 


molizeemore Soecific information on these Support routines 


see Appendix B. 
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ieee Cem bl SPLAYS 


The RAMTEX hardware imolenents color by combining red, 
blue ana green in varying intensities to oroduce the cesired 
color. The varying intensitities are stored in the video 
Meexe-U0 tadle (VLI) for access by the hardware. The GX=100A 
can generate lo levels of intensity for each of the three 
Meee colorsS, whica results in 40°6 possible aifferent com- 
Beemetyions. The ovossibility of 4096 aCe colors does 
Mot mean that the user has all 4096 available at once! The 
mermeen software allows for 18 color tables of 16 color an- 
tries each. This means that the user nas access to 2838 


Memmors. The Gx"l1l004 can access only one table, with 16 dis- 


Mme COlOors,s at any given time. 


meopeclarity the nardware video loox-uce table will o5e 
Memerred to as tne color Feex=uo tao le. The hardware 
Meeessidble color Jlooxeuo table can store sixteen (io) 
Separate colors. [his constraint is one tnat the user should 
De aware of, but not concerned with, as the software suoport 


mowtines allow Bremuse tur owovercome EhIS restriction aquite 


memmey, through maniculation of tne tables. 


The software that orovides the color suvoort for the 
pericnK allows tne user to : 


Diane ororeacetimed colors. 


te 





Define his own colors. 

Select olor sets. 

Serectmsoecific colors within a set. 
ltieuceactywely modity colors. 

Save color taoles. 


ReSGeore color tables. 


[ext and/or agraohics nay be disolayed 1m anv oefined 
molior. Bpeomayteyare sSuceGort allows the user to defi-ne vir@- 


Bauer ly any color that he gesires. 


ero lt USER GUIDELINES 


mre RAMTEK software oreloads 4a set of color tables for 
the user. tmesemtoogles orovide for the color needs of most 


Meagrmaming to internediate users. 


Meee est'EK supoort software orovides the user with a set 
Bec Oo!s that allow him to select the color to be used for 
Syeseinav. ihe user must cause the aoorooriate color Ilook-uo 
meme tO be initialized and tnen he may select from colors 
mem 1t. Fhe initialization of a oarticular color tadle 
memmmoccomp!ished by invoking a supoort function “colort(n)". 
femme cOolort(n)" is called the following actions take place: 
hmcO1oreGacle nm 1s loaded. 
CC. All disolay imaqes on the screen are refreshed 
Pibneeme mew color set . 
MmnemmaGckenroumd color of the screen 1S set Te, 


entry zero of the new table. 


is 





Once the user has loaded a particular color table, he 
Memes ixteen colors availabie for disolay. To then select a 
color from tne tacle to he used for display, the system sup- 
merit tfuMction “color(n)"” is utilized. All images displayed 


WW 


Pmecequently will be cisclaved in color “"n" of the current 


eemror table. 


Of the eiahteen tables established by tne softwarer nine 
are filled with predefined colors and nine are blank. Four 
See mese taoles are orotected from user modification (0-43). 
These protected tables may oe utilized nut not modified. The 
mime predefined tables orovide a sufficiently large color 
Selection for most users; however, there are a total of 
eiahteen (18) color tanles snould the user precquire more 
Mmmexroyility. The nine blank tables must be defined or filled 
by the user if he desires to use them (see the exolanation 
mameeovanced Coior “ethods). The colors present in tne nine 


Smeeetined color taoles are listed below: 


MOLOR TAS8LE COLOR 
0 Shades of grey 
} Shades of plue 
a Shades of areen 
5 snades of red 
a mixed 
2 mixed 
6 mixed 
/ mixed 
te) Shanes of yellow 
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Tne RAMTEK user software allows the viewing of any color 
mae im the svstem. For the user to look at 4 particular 
color table he need orly issue the aoprooriate system call. 
Two different types of display are available, an expanded 
paeeo Orief display. nomontetewelsolay Tay be selected dy 
the system fume t Von aiseveto\ Cn) 7 the expanded ety 


maaso(n)". 


4 9 


Mmimeoeworiet disolay causes color table ‘n to be disolayed 
Pememcolumn of poxes in the individual colors of color table 
Semel ne exoanded disclav aives the user not only a column 


muameaxes, OUT lines and alohanumerics i31n each color, as wel] 


[mmmer octal code that achieves that colcr combination. 


The best way for tne user to onecome Pam | et Wiatatin the 
Mmemeents and suooort functions introauced 1s Sy using them, 
Three executable oroarams have been orovided for the users 


convenience. 
es PROGRAM 1 


iors procram 1S 9EeSiqned to demonstrate the orief 
memmor table disolayr loading of a color table, selecting a 
eemercular color entry from a color taoler, and the result of 
mumeerortrcular color selection. Tne ecrogram wll fiest 
display color table seven (7) in the crief format, then der 
Mmeumm~mmrar Sstx (6) seconds and display a box tn color four of 
color table seven. The user nay tyoe the orogram in himself 


om use the Gar. ete woe re yt eExiSts in Hoth the source 
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Oe 
- 


form and an executable forn. 
Beto use the esc000 file type ; 
BO ice se 000 (c7Fr 
PRooWURUS student ¢c/7r 
cd ramtek c/r 
mero list @the program: 
Imecten=G LOM. c G/F 
malo execute the oroegram: 
Ouleeex «07 Fr 
a. For the user who aesires to Inputs, compile, and exer 
ace the progdran ninself a listing of the source code 
moe corovided. 
main() 
imameek (ie //imittalize RAMTE 
erase(); //erase the screen 
G@spveto!(i); 77aisolay color table ? 
Seoretvt,e77serect color table / 
color(4); //select entry 4 
sleen(o); //aelay o seconds 


Pte routine “block” will be exolained in a later 


mmampters it should not concern the user at this stage. 


eee F ROGRAM C 


mInGex ama lenis destanea to introduce the user to 


the exgoanded format fer daisplaying a color table and the efe- 
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fect on the screen image of loadina a new color table. Pare 
Mreutvariy the example disniays color table six (6) in the 
Beepanded format, delays six (6) seconds ano then loads color 
table five (5). The user should note that when the new color 
table is loaded it is effectively disolayed, but the text 
Sci || Mmmerecotes ss thatummyt 1S Color table six (6). This 
muromeryonts the fact that all of the information displayed 
changes color but the information itself remains unchancea. 
a. To use cse000; 
GUC csc000mc/r 
PASSWORD: student c/r 
Gar ramte< ¢7r 
Peo list the proaram: 
Misia Gs Dc ec 
clo execute the oroaram: 
De exc/ F 
d. To tnout the croaram the following listing is pro- 
vided ; 


nain() 


romeek( ol, S/in1t1al1ze 

erase(); //erase screen 

Color ucaj7m/7loagd color table 
GQisementey /GiiSoO: ay Color taole 6 
sleeolo); //delay for 6 secands 
Soop G7) /7 load mew color table 


} 
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Pe eROUGRAM 3 


This example is desiaqned to emohasize the effect of 
mre displey color selection. Color table seven(7) will oe 
meaed then a box disclayed in color 3 of that table. A 
mmermt  celay will occurr then another box will he displayed 
memeeclor four (4) of that table. The dssyctbo!l option is used 
to allow the user to verify the results. 

aeTo use cs2000: 
MeCN. scs2000 c/r 
Boson er os Stidgent c/r 
Goemonte< c/r 
ferro 11St the oroaram: 
mice GO 5.c¢ -C/ Tr 
Selo execute the crograms: 
Sek. Cs fF 
Beeeine Program listing follows: 
main() 
{ramtek(); /S//initialize ramtek 
Soormei 73s *//Select color taole 7 
Ssevewolt,/); //d\solay color taodle 7 
SOlomesle //Select color 3 
ISGRaA BOx if color 4 */ 
Seroce G50 0 7 /5.0595.0,5.0)7 
Ssleep(5); //celay 6 sec 
Scmort4aj, //select color 4 
pee GO, oO.) ,O0U,0,20.0)3 s//aoraw box color 4 


} 
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Tne user should now Fe capable of writing sorograms 
meer ilize basic color manitoulation techniques. tne remoare 
more complex and soohisticated options that are covered mn 


mmemnext section. 


Bee OVANCED COLGR METRODS 


erembeasics for Color manioulation recuire Jittle effort 
on the part of the user. Since the more advanced user may 
need to solve a more complex problem, the RAMTEK software 
has been desianed to assist the user ang simplify these 


eam@ertimnmes comolicated tasks. 


The hiaher level uSer-oriented suoport routines are prio 
mal y to allow the user to modifv existing color tables, 
mend mew color tablesr save a aqrouo of color tables, ana 


Mimere to an active status old color tatles. 


Meee OCIFYING COLQR TABLES 


The modification of tne 1&8 color tables may pe ac 
complished by iitslt zyme the data tadlet or the RAMTEK key-=- 
mere o. cach of these techniaues wil! be discussed SO thet 


the user may intellicently select tne aporopriate one. 


Pee oA UA TeaSsket METHODS 


nema vstemiesottware that Suigooerts “date tablet 
eolor fmeamroUlat tom 1S cCcOomoact ana fast; this wi!]!1 be an ade 


vantage to the user who reauires onw=line color tacle manipu- 
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meenom . in order to execute this susport cackage the user 
issues a call Crmeenest oem « cabcolor();. fhe system will 
meeame prompt for the required inputs to alter and/or build 


color tables. 


The userworiented routine "taocolor()" offers 
one of two options : building an entire table or changing an 
existing table. Tne tablet is viewed tm this anolication as 
per temclate e@ in the Lan. Once in execution the SLoOdram 1s 
meeorial in nature and will oromot tne user for required in- 


Bouts. A Samole session 18 oOravided to familiarize the user 


Mmmmemecolor manipulation via the data taolet. 
ici) PROGRAM 4 


This exercise is gesianed to familiarize 
the user with the techniques used by the data tadlet color 
fMemioultation functior. 

Mimo use the csc000 file tyce : 
Sti: Soe 00 .e/r 
PaSSvORD: student 
Cawramtek c/r 
(2)To list the source code: 
liSheec C4 .C 4C/r 
(3)To execute tne oroaram: 
eax Oy tt 
C4)For the user who wishes to inout the source code 
himself a listing is porovided. iT se Smeagran iartial= 


mzescethe FAYIEX, erases the screen and then calls ‘dane 
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action the data tablet color manioulation package . 
main() 
fromtex (lemme, 1NYtia!ize 
Saermee)s 77imytialize teabdlet 
erase); //erase screen 
maaco only 7call V.Ge tablet routine 


erase l)> 


Senate oan FETHOOS 


inemoOurcoserot) this interactive orogram 1S to 
allow the user to see and modifv the color lookeun tables 
while seateq at the RAMTEK kevboara . This extensive 
software packaade Wo 8vVerye orse once Should not be used in= 
Seeseriminately. [t is hiahly recommended that lt soe used 
only to build a set of color tables-s then save these tacles 
to be loaded into the users ornaguction program at a=l|ater 


meme (see saving color tables). 


For a comolete exnlanaticn of this oction see 
Mmmeme Gescription of Vater () sim -ofcenc!x 4. If the user 15 
meme rested in utilizing this ootion he should execute tne 
BoeraQwingG orogqram to get an aporeciation for it's capanili- 


ties. 


Coe eT UGRAM Ss 


This examole program initializes the RAMTEK 


wmeeca)|s the interactive color manipulation routine. 


et 





faeto use tne csc990 file tyre : 
BUGi CSc000 cur 
Poco. student <«/r 
Gderamte< ¢/Tr 
Gor tlio list the orogqram: 
Estee G O5.¢ C/T 
Merlo execute the orodgram: 
Boex c/ Pr 
We) Frocgran Jisting: 
main() 
VeamtekiG)j, 7/initiealize 
erase(); //erase the screen 


ieee e777 call coler moanmio. routine 


Pnemet i t2atiom uct smter() vice tabcolor() 
Pammeeresuit tin the user Orogram beina 6948 oytes larger. The 
Buezenotr Orograms being a consideration in software desian 
implies that inter() snoulad be used selectively. There are 
Meemeric acolications tnat require it's use and it will oere 


form well in these aoplications. 
Cie WaT AL GCOLOR LOADING 


ine wsyster O©frovides for tne user the cadability 
Memmerogrammatically toad a oarticular color tactile as an are 
Pay of entries. This crocess 1S more cumbersome ana less 
Mmexrolie than the other two color manipulation techniques. 


Meeomerogranmatic loading of a color table ty the user forces 


Be 





him to preselect colors and manually provide the mechanism 
for loading -» out in small uncomplicated apolications af- 


Moenpgs the user a feasidle solution to his tmmediate oroblenm. 


Tne orosgrammatic loading of a color table is a 
mmemeestec process. [he first steno in the orocess 18 to con 
struct an array in his prooram that defines the selected 
color intensities. This definition of colors 18 accomplished 
by first declaring an array of 160 elements, since Sete 1s 
the number of elements in a color tapdle Pel wear a viens t 
then be aiven the anocropriate color intensities by a system 
meeeteware routine call to tricle() (see Acnpendix 8, tricle(), 
fMemespecifics). The tricle routine returns a coded vatue 
mae reoresents the aonrooriate color mix. Gnce the array 
has tne aoorooeriate ceded value it 18 then programmatically 
meeead Into the master array of color tables by calling the 
System routine "cirtbl(t,a)" (see clrtbl, Aopenaix 5), where 

Hou 


tc moe the number of the color table to be reolaced and "a 


femecme mame of the color taole holding the cogeo values. 


DRicomenoceceure may seem comolicated and is prot= 
ably better IWiwSte@ated by an examole. The user 15 en- 
couraged to execute the examnle oroaram to exgcerience the 


SROcess. 
(i) PROGRAM 6 


This orcaram takes a certain predefinea set 


of eoior mixes and Cullas GQlGe Utab1e 9. Unce tre color 





maple has been built, it is Re sol sven fon the UuSer to 
View. Boueaocwterom 8to CdiscOlavyvinGg the color tadle, a set of 
intersecting lines are drawn tnat intersect at virtual 
meeeenm comordinates (5.0-,5.0). The lines are drawn in color 
mmorecolor table 9r the one just built. 
Wa) io use the cs2000 file tyoe: 
POEUN mese 000 “c/r 
PASSWORD’ student c/r 
ede farte< ¢/r 
Moyo list the program: 
mister -G 0o.G, ¢c/ Tr 
Meio execute the proaram: 
Son x "c/ - 
moe Frogqram listina: 


int allS5l]l¢ //declare array 

main ©) 
Vie ome eke) Vea ek iealiez er nam tek 
Preset ecolor ratensities into array */ 
Howat vowe( fovea, lo le- 7//white 
slliegricie(!>s,0,0)7 
Meet Cie le (Uy toy 0) > 
Sloat 361 ecu, | 5): 
al4jetricle(3,14,2); 
ad ae eGwe) elo, 15,0); 
AweG | waite VC ke (ay oo } 
ey laf eit pale eG aie) es 
Slade Winco ec 0, O10) > 
Sle etre le Ge poy ©) 
aclu l=tricthe(0,5, ec); 
alt) =tric leCh, 0,4 )3 
Serio le ClO. 10, 10); 
alist =trivolet4, 9,1); 
ewer Chie helo,, 5) - 
at oer yo |e Sy 1,15) 7 
elrto!l(9,a)7 //load master array 
Scovereert sis S/eCisp lay color tarhlie 9 
Sermucro, color (4), 7//select color 
SameomuunO,020, 102.0,1050)% //dimension Screen 
Bc @ore 7 ae), | //draw axis 
} 
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The user, havina now executed the sugqaested 
sample orogqrams, should nave a good aooreciation for how to 
create and manioulate color tables. If more in-depth infor- 
mation 1S required, the user 1S encouraged to research 
Memmerences | and 3 for the specific hardware and supoort 


design. 
meee Oh VING COLOR TABLES 


As mentioned earlier, the system color tatles are 
initialized each time a uSer Feains a session. These colors 
may be alteres bv the metnods aescrivted avnove. The aodility 
mom save the current state of all color tables for use at a 
mower time not only enhances the users capabilities but 1s 
an avosolute must for production nprograms that require cero 
map color sets. The user will certainly amoreciate the 
problem if ne considers tne case where he has defined a 
Seeeeoe number of specific color sets for distinct apolica- 
Mmmoms USING “tadcolor()” and/or “inter()"+ and has no way to 
Save them. Witnout the color savina options in oraer for the 
user to continue to use a snecific set of defined colors in 
Beeeoateo runs of the same orogqram, he must reconstruct them 


each time. 


iret rlizing the save color option the user must be 
Aware of two routines: 
Wiese OE 


peScelmt.)- 


Mmemroutine "“"savelr()" saves the entire color array nepa me) 





memerecatiled “savcol”". The rotuitine "resclr()" restores the 
mime ‘Savco!' into the active master color array so that the 


user may reinstate a seecific set of color tables. 


‘ale 
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Vilin ee ePmaANUMERTE MOOE 


A, INTRODUCTION 


ims mode is used for aisolaving alohanumeric CASG EY) 
Characters on the PAMTEK screen. The basis of this mode 15 
Mme transformation of the incividual ASCII characters into a 
Meee matrix boy means of a character fort. The font defines 
this matrix to be five screen elements by Seven Screen lines 
in dimension. This character matrix is actually disolayegd 
within a seven element by twelve line matrixr to nrovide 
memeration of characters. JInis 1s illustrated 1n Apoendix B 


of the RAMTEK GxX-190 Frogrammina Manual [1]. 


mre ce li scharecters are disolayed startina at the 
Mmmeremt Operating Positien (COP) from left to riaht on the 
same line. [f more tnan 9i characters are written cn one 


mume, they will “wrac around" and over write the beginning 
characters on that same I ietec Cl the ootional "“deuble- 


Mmmm size characters are used, the maximum number per line 


me d>. ) 


Mme nanoc!iicable gots (o0ixels) in the character matrix (as 
defined by the character font) will apoear in the current 
selected color, while the remaincer of tke ‘ott 1x will be 


mmmed in” witn the current backaround color. 
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SmeeeoaslC USER GUIDELINES 


As mentioneg earlier in this manual, the software suc 
met | «6Opackagqe for the RAMTEK is contained within the UNIX 
mer systems in the form of a library of subroutines written 
feethe 'C* programming lanauage. These routines are accessed 
mag any of the terminals on the "A" system) by compiling a 
user-created ‘'C' program containing references to functions 
that reside in that Jltborary. The Soecial snell conmana-§ for 
mamor!i1ng a orogram that calls routines from the RAMTEK lie 
mmaipy 1S called "ramtek", and needs only be passed tne name 
maeeecme file to be comnoilec. 

men a2 command woulc be of the form 3; 
ramtek Piere Game .c 


Maetenthat the file must be of tyoe ae 3) 


Ime first oraghics routine that must be calleo from 
WitniIn the user'S Crocram iS+r In every case@r the one that is 


mrco mamed "ramtek”. (This should not be confused with the 
she] ] command above) This routine ooens the device, erases 
the screen, and estarnlishes user access to eee [Res Ca lil 


mom anopear as follaws : 


ramtek( ); 


To place the RAMTEK device in the Alphanumeric Mode, tne 
Meomeemay utilize tne “setmode" routine, with a call of the 
norm $ 

setnmogae(0,9); 


muote =: the Alohanumeric mode has been osefined to he mode 
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a 3 the second parameter of "0" turns off any opreviously= 
meprected contro! flags, 5 ee (a in fia SOS) © Vom wou lic 


oreserve these flaas.) 


Blthouch some aisclay routines will automatically set 
Mme procver mooe, it 18 Go00 oractice to include this “set- 


mode call in user orcograms. 


The user 1S Now ready to select the area on the screen 
Mae nich he cesires alohanumeric data to be disolayed. A 
mmmex review of the initializing “ramrtek( )" routine woulda 
reveal that the virtual Screen nas been dimensioned to 100 X 
meeerand the Current Ooerating Position (COP) is locatedqd in 
the lower left corner (coordinates 0,0). If these dimensions 
are not favorable, tne user may select hisS Own with ae cal) 
Mmemeene screen" routine of the form : 

Screen(xminrsyminsxmaxrsymax) > 


where the oarameters are real nunmoers. 


im amy caser before a cal!) fo, one of the disolay 
Bemeines, the user shoulda confirm the location of the COP 
meme, Cpoint at which the cisolay will] begin). The COP may be 
rewestadlished bv a call to 

Stirt xy (xp y), 
where x and y are) real numbers [armeuethe desired virtua) 


Screen coordinates. 


For the simole aoclication of disolaying a single chnar- 


Mm~m~emom the screen, the orocedure called “Ittr(ch,-size)”" is 
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moead. The call is of the form 3: 
it Gps 7 S1Z2e) + 

where the character vsesired to be output 18 enclosed 1n Sin- 
Mecmemrcuotes or its ASCII code is given without scuotes. The 
size is passed as either 1 (normal size) or 2 (double 
meen). All} control bits or flags remain as oreviously set. 
Meemcmaracter 18S disolayed at the extsting COP. No line feed 
meeurs, Nut the x=value ts incrementeda bv 7 real screen eleo- 
memes aS a result of the outout. (The COP moves to the right 


7 pixels.) 


mmemnost Straliacht=forward aooraach to displaying a set 
Meee l characters, such as a block of texts, is with a call 
memetme fFOuUtine "texto", Which requires 5 oarameters, in ord- 


[eas follows : 


1. The address of an array of pointers to the texts The 
oOoIinter array snould have been geclarea as pointers to 
an array of variableslencth character strings. The aco 
tual Smaveewvmenarcacter StFInas should be initialized 
followina the array oeclaration cosy enclosing eacn 
string in douole auotes and senarating tnem by commas. 
The last element should be a zero, witnout quotes. 
(see example below) 

Pee ihe number of the desired color table Can integer 
value :; 4 = 17) 

3. The numoer of the gesirea entry from that color table 


Cinteger value : 1 = 15) 
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ieeem imteaqer value (1 or 2) to denote desired character 
Sue2 ee If this oarameter has value 1 the characters 
are disolayed itn nornal sizer if it has value cs the 
characters are cisolayed in douole wiath size. 

5. Am integer value (V0 or 1) to agisable/enable tne aadi-=- 
tive Werte Gaoao1bity. If this parameter has value l, 


the corresvonding text will be written On Cems Of 
Cie, Umecarttcm to == mot in replacemert of) the exe- 
Mmetum@Q screen image. [f the value 1s 90, the desired 


text wil] reolace the contents of the refresh memory 


Marat ExX1YStS at the soecified locations. 
le PROGRA™ 7 


Pme wexectution of this orogram wil!) disolay tne dee 
meee o block of text in doublem=width cnaracter Size, Start-~ 
Meoeat the virtual screen coordinates (25.0,/5.0). The char- 
acters will be written tin tre color specified by color entry 
meer color taole 7, anc will reolace any data oreviously 


metren tnere. 


foes eocearsan woulad normally be comoiled usinae the 
a’ moemoyler im conjumction with the system litrary of RAite 
Meme subroutinese via the followinq command : "“ramtek 
filename.c", where filename jis the name of tne user file 
Containing the crogram. However, this example is available 
Moe xecutable form in the "cse000 - ramtek” Girectory on the 
Mmmeesystem. (see Chaoter II, OGnerating Instructions) 


mmo use the cs2000 Girectory : 
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SUGiN sescOU00 sc/r 
EHoOSNORDs  stucgent c/r 
ea -ramtek, ¢/r 

oe io list the orogram : 
pore sc (Of oc c/r 

Cc. lo execute the orogram : 
oy. < eve 


Beer he listina follows : 


ae 


memar *txtif{ ] /* declare and initialize the x / 


{"Wnat you see ", i= GOvmcer  sacroay anc text «x / 
8 te 


1s what you get ’ 
wnen You Gall ea oe 


#e TE XTO aor 
0 
by 
mat ctaol 73 LESCOL pe ao Ve ss. */ 
Mae coll 5; IT CGroOreent ry) 35 */ 
int szl 2, ZPPOGUo1e wrath characters *7 
int wol O07 FRVGO-write=over *7 
maim( } 

{ramtek( ); /* open the cevice) */ 
peepee we Y¥ 62.54.0775 .0);3 [PIECES tarti ng Cont -*/ 
Memeo lrxt |! y,Ctaols,coll,sz2i,wot); 

} 


Bee OVANCED METHODS 


After a review of "texto" in Apoendix 8, the user shoula 
realize tnat its advantaces lie in simolicity and generalic 
meen 6€©6Corder€6tOol6Urperform.6umore)6=6complicated alohanumeric 
display tasks, the user may wish to proceeac to a more de- 


meamped level of ocreratians. 


mmrthner analysis of “texto” woula reveal] that it actuale= 


ly makes a Serieseor calis tc tower=-level routines. These 
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routines mayr of courser be employed individually. 


Mmoempetore, the first steo in Gisolaying characters 18 to 
insure that the system is in the Alphanumeric moce. This 1s 
mecomplished by calling the routine 

setmode(ar,b), 
massing a zero value to parameter a. Farameter h must rem 
memes eitrer 32 0 te turn off all control flagsr or ait to 


leave control flaas as presently set. 


Again, if the user wishes to change the dimensions) of 
the virtual screen, he may call] the procedure 
screaen(xminszyminexmaxrymax); 
emopass the minimum and maximum values cf the cesired coor- 
dinate system. This erocecure leaves the COP at the lower 


fmemetecorner of the screen. 


In orger to select a aesired working color table, the 
user may call 
Gover tur js 
passing the number of the table to the oarameter t. Tnen the 
Beemonpriate diselay cclor entry is selected dy a call to 
GOllon we) + 


where e is the entry rumber from tne selected tandle. 


Morestaclisn a new COP for a particular display, tne 
mmocedure 
strtxy(xry)-? 


mame | ized with the starting X and Y coordinates (as shown 
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before) being passed as real oOarameters. 


Tne s1ze of the characters displayed may be ordered by a 
ail to 
Szets); 
Meee Ss beina either ! or @.tIfs ig passed a value of le 
the characters wil] be displayed in normal sizer 1f a value 


of 2 1s nasseds, they will be aisnolayed in double width size. 


The selection (Cor deselection) of the ‘anaditive write’ 
feature (ie, the intention to ‘add to' rather than replace 
the present screen image) is relayeg to the system by a call 
te 

writon(w); 


meee FeCeiving a 1 if write-over is desired cr a 0 if not. 


The actual next-level display routine that 1S called 
een by "texto" 1S ‘“Steeout(s)";, where ¢$ 16 a COoInter to 2 
single strina of less than 100 cnaracters. For example, if 
@m@emuser had the following daceclaration in hiS DrFOGgramMm 3; 

Sameesemmeis) {This 16 a String. "}; 
meme a cal! of the form 
Simoul @S win ine )-s 
would display that sentence on the screen. It should be not- 
Bemeemere that after acall to "“strout", an automatic line 
feed/carriage return is nerformed, leaving the COP on the 


next available line and at the same element position as the 


previous COP. 
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Momcartyetmis AiscusSsSi9OM one step lower in the struc 
ture, we point out that "Strout" actually counts the number 
of bytes in the character string and passes this number, 
along with the acdress of the string, to the routine 
"data(name,lenath)". This routine 1s also available to the 
Meer if he is certain of the number of bytes in his charac 
Mere string and does not attempt to pass a string that is too 
long. As an examoler with tre same "“enar string" declaration 
peowpove, the user could write 

Gatealstring, 17); 
memeaecomclish the same task as "sStrout(string);". This 


mor ine also beeves the CUP on the next line and same ele= 


Meme as the previous COP. 


f 


meer Some error checkina and setting control oits, dao- 


1 


ta agaones one steo lower by making a system call to the 
mame rOuUtINe, which transmits the raw oata Caccoraitasc to 


the byte count) ce) Pacer e teK instcuction bUTfer for imn= 


mempretation and aisplay. 


fees imiltar imsmection, we fina that “size” actually 


t 
A 


men itizes 3 lowerwlevel fOUl Ime Collea cdolwid to set the 
Memeo riate control bits ana "dumo”" this data to the RAMTEK 


worrer. 


mem dum routine exists at about the lowest level On 
the user motrertace. fo, coiyrect |y utilize to1s foutine, the 
user is aavised to aain 3a greater familiarity with the "RAM- 


Mere GxX=-i00 Programming Manual” [1]. 
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feo ReGkAM oc 


Mmesesomole orogran will demonstrate the use of the 
Seromanumeric cisolay routines mentioned above. It 18 avails 
pee for Viewing 1m the "cs2e000 = ramtek" directory. ites 
execution will result in the declared string of alobhanumeric 
characters beina disolayed, in tandem, at three successive 
/meeations On the screen, and in three gifferent colors. Note 
Mmraet the seconac aisclay call in each instance is not precede- 
memmmey a Call to "“strtxy". This denonstrates tne location of 
MmmemcCr after calling either of these disolay routines. 

mo USE the cs-U00 directory : 

Bgelte ese000 ¢/r 

Besant Stucemt c/r 

Gan ramte« C7 Tr 

fei o® 11st the orcoram : 

Mise G Oe. C Grr 

mero execute the procram ? 

Bre: x evr 

feeeime 1isting follows 3: 


Mmrimeestrinati { This 15 a strina.”"}; 
(7 SiG Vaa declacat ion 


main() 
{ramtek()> LP OCeM Che dev ice 
Semeemil.0,0.0;,10.0719.0)3 //dimension screen 
Goloart (7); LI MSE Veet CoOVOr “taohe / 
Go vor |) > Le Select corer. | 
setmode(0,0); // select alnhanumeric mode 
size(e); // select double-width size 
Suu y 60. 557. 0) , (set star engage Cone CCOP) 
Suneut Gst rina) ; [i Osouns y mere 4 Str MG 
Maetatstrindgs |i); J7~wAvsolay Same Sstriag 
sleenp(2); // pause e seconds 
Ee elie V7 eCmanae calor 


ae) 





Sirbryi oe usb. JU) // chanae COP 
Stroutet(st ring), // repeat aisplay 
GidesGsctirimar!/)7 fe ee y 
sleep(e); 
Gowen (/) 7 fp Mehamae Color again 
Sumuxviioesrnss0)> 7/ chance COP acain 
data(strings!/7), // reoneat disdlay 
Su@outlStrimGa), // frepeat disp! av 
This same disclay could be achieved by the following 
more concise program, better utilizing some of the features 
Seer me ‘CC’ progqramnina l|ancguace. It also exists 1nN execut= 


able form in Bnew ece 00 =) ramtex directory discussed in 


Mmapter Il. 


eC. PROGRA' 9 
Meee the initialization of variables in declaration state- 
ments, and the use of assianment statements and expressions 
as Oarameters in the procedure calls for "color" and 
Meerexy”. Once again : 
mmo Use the csc000 cGirectory : 
SOG sesc000 i¢/Fr 
mec omoue Ds Stucent) -c/7r 
GG ramtek  c/r 
Oee1o |ist the croqram : 
mes tum=—c G7? .¢ C7 
eeeiO @€xecute the ecrogram : 
Oo. x Cy 


eine listing follows : 


maorestrimot) {"This 1s a Strineg."}? 


float stx 7c.9; foment ie vce est ort yng A value 
moat sty 9.0; ae ss ‘ Y a 
masta «> 
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an came 
ramtek(); 
Semeem Cau. Uy 10.0, 0.0); 
setmode(0,0); sizele); 
Golore Cc? )7 
GorGie=—0e 1 s= 6,1) = 1+ 5) 
{color(1+l); 
strtxy((stx = stxt2.5),(stv - i));3 
Strout CStrima) : 
erat a.CS winemiaral / ) ¢ 
sleen(2)> 
b 


QR 


t179 84 4c FF @ re = 
tsieste 100 GTEE 
Se 
‘> = 135 
‘jsolae 
\yetrse 
(eyes Fe 
32 +e7ee 


; ‘aeotls 


a 
, 


( 





Vivien saver Sse DATA MOCE 


fan seemroge 1S Gesianed to alicw the user to cdefine and 
draw irregular imaaes im the vertical olane (8 elements 
meee) cf the RAMTEK, MRese traures snould be in .a singie 
memror, as the facility for changing colors while processing 


an image coes not exist while tn the transverse data mode. 


imewuSer NUStE Gain s Superficial understancacing of how 
Mme RAMTIEK processes his data in this mode to bce able to 
meet he mode effectively. Tne bit feattern of a set of user 
defined data words (bytes) describes the image to be 
displayeac. The user wil] dagefine data words or bytes; recgara- 
Mess Of which he chooses, the RAMTEK interorets the data 
Mame bY Hyte (a byte consists of eignt bits). The bit vbat- 
Moma Of each byte turns O% or OFF indiviaqual oixels on the 


PEMIEK screen. 


MeeoGtal number in the C programming language Re 1S 
denoted by a leading zero. The octal form of numbers wil! be 
used excluSively in oreparina transverse data, since it 1S 
Seaesrer. Lf the user was to cefine the data woro "x" as "x 
Pmeomovece (x is of type intecer) then it's obit by bit 
Memmesentation for the system would be: 9U01101900909010010., 


PmemRAYTEK would further decompose this word into two data 


bytes Pte Olwamd JVOU0190010). The date bytes are then pro=- 
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cessed by the RAMTEK sequentiallys beginning at the user de- 
fined starting point (see "Strtxy"). The eiaht pixels to the 
meant of this point are interoreteaq as either GN or OFF 
dependina on the value of it's corresponding bit in the data 
byte. A one indicates that the onixel is to be turned ON; 
zero indicates the OFF state. Each consecutive byte 1s then 
written immediately telow the last one until al] are pro- 


merece (see “oaata"). 


Memeoeolitl UStR GUIDELINES 


Mae very likely acolications for the transverse data 
mode are definition and disnolay of soecial symbols and ir- 
meog@isar Vertical images. Software support routines are pro 


Maded to allow the user to perform tnese actions. 
Ie, SEECI Ae SYMBCLS 


A common use of the transverse data mode would be to 
define special symbols that are not providec 1n the stann 
mira character set. For examole, the user may desire to 
Mersmilay the towercase Greek letter alpha. By defining this 
Bemeeer 3m a linear array of lenath six (words), and calling 
mmemeesystem suepsort function “symbol(sy)", where "sy" is the 


Mmeay Name, the user ray disolay this special symcoo | quite 


easily. 


To define a special character the user should nig oe 


Graw a matrix (8 bv 12) and develop a grarnical renresenta~ 
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Mer or thet Character. For &xamele, the lowercase Greek ale 
pha vould ne: 


ey it 


cede mee Ge Ge nS me et 


+-= —_— — 





The next steo for tne user would te to transform.) > 27s 

mimes 1c renresentation into a data representation trar can 

he utilizea cy the support package. Transforming the grarcr - 

cal representation cf the lowercase Greek alpha into a vir 

aole data representation 1S accomplished as follows: 
astransform the graphical View Masiete, the binary 
recresentation. 


(="Fecresents a Olank 7? * 4 dot) 


ly Wie GRAPHIC PItARY 
== ----- - OVDQUG0N 
OQ Se S66555 0D0GV00UD 
$ were nreee QGOV00000 
u ee SOMES TU 
5 wc ke keken Or ns) 
6 kweriee- 1GGd1L49UG 
/ ek ohokeon YV1IGIOIOE 
a) ee ok NOLVQHL) 4 


101 





9 9) eesesese 00000000 


ee = 00000000 
lu! a 00000000 
te ee 00000000 


Be Varry oairs of nytes linli@  Weume oe ites is done 


sequentially from the beginning. 


Si eS BINASY NUMRER 

| e'igite: NIDINIGCOOHQNGIDD 
$ ana 4 VODODOIQVIONLO0NLY 
5 and 6 OO Te Ly OLo0e 1000 
7 and & iO dt oe 1 :OnrO 0010 


Sand 10 ¢400000000000009 

Ll and 12 00090600800000900 
fimese Six words, rcecresented in their cinaryvy number 
form, provide the most kasic data form of the lowercase 
Greek aloha. 
€¢. Jransforn the binary reoresentations 1OeC.. 4OGe a 
Numbers for processing. ais Si laleyp ay te, OGta: “transit or- 
mere om 1S Gone from right to left. Each binary word is 
Mme 1ded iimto 5 GrouoS of three birary digits, with one 
memory Giaqit jJeft over. The position of the ones in 
these arourinas rerresent powers of the numner two. Jne 
leftmost diait reoresents two squared when a ane 15 = #I/n 
this location. The center diait + when oner represents 
Meo to the first power. The rightmost digit reoresents 
a ane (two to the zero cower). Sum the numbers in each 


PROUD Of three to yield one octal giait. 


lara 





Ceo ULC wet O 6 6—610006CUO10 


Thus the octal reoresentation would be: 005¢04e. 
G.- An octal wora, as oreviously stated, 18 denoted by a 
leading zero. The followina six octal numbers represent 
the lowercase Greek alreha descrived above: 

0000000 

0000042 

Cwaee. U 

0052042 

0000000 


0000060 


Now that the user has an octal numoer to aefine the 


special Svymtol, he mav Generate that symtol by calling the 


Seotem Support routine "Symbol(sy)", where "sy" is the name 
Beene user defined arrav containing the octal cefinition of 
the symoo]. The user shoulon verify that the octal code liste 


ed above 18 correct. 


a. PROGRAM j0 


tris eOGoeGgan 1S eS) Gne0 to Show the user the 
meemeami1cs of duilding a Soecial Symbol ano acispiaying that 
Seamioo) om the RAMTEK. The Greek lowercase alcha will be 


Beesoayed in stanaard size and double width. 


Ges 





@lytewuse cse000 type: 
BOUCHE -es2000 e7Fr 
BpioomerDs student ¢/7r 
ederamtek c/7r 
Mente }1st the croogram: 
lsvisuvecwe (DO 1U0.C. C/.Fr 
(3)To execute tne croaram: 
Sie < (6/ F 
mee rogram Listirna: 
VXI ORe ARRAY «7 
Twoional ole OU00000,0000042, 
N052210,005204e, 


0000000,00000900}),; 
main() 

Geared ly ¢/ mit 1a) ize 
Sipe Ga2e0, 50 20), //set CUP 
colort(/); //select color table 
Goltentee)s, sS7ealor < 
symbol(aloha); //outcut alpha 
agolwid(l); //set doucle wiath 
Gene lsU. po), 7F/estanlish COP 
symool (aloha); 


} 


pee IRREGULAR VERTICAL IMAGES 


PemicmouTtemGlausiole to consiacer the use of the 
transverse data node to define irreqular images. The system 
Boertware supports the desian ano display of celumns of jn 
mormation via the function "tdataltotr,by-,ex,lv)"-+ where 
meotr 1S the name of the array (oointer), oy is the 
meme r Of Sytes to be output, "ex" is the cesireo Starting x 


Maiue, and "ly" is the desireca starting y value. 


The user might cesire to develoo a set of oversized 


Parentheses tooo mec Ts awe eltoeatrom. 'h1S 1S accomo!l1ished 
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by first acefining the tmaqe as aiscussed In the previous 
Section, then via "“"toata" creating the disolay. Suovovose thet 
the user has oefined his virtual screen to be 100 by 100, 
with (0,0) tm the lower left corner. Perhaps he has use for 
a set of oarentheses that encompass 29% of the screen or, 
more specifically, 45 real screen lines (.2 * 240 = 48), He 
must then cefine 48 bytes oer image to accomplish this task. 


Mremaetinition of the data is as discussen previously. 
es PROGR&™M 1] 


ia SeOgeOemoem snows t-e "user the definition of a 
set @ f parentneses, as Discussed adove, and how to create 
mememinmages on the screen of the FPANWTEK, 

Mmiyic use cse000 tyoe: 
HUG esc uC) (e/« 
PrRoovURU. “Student c/r 
CO fFanrte. c7 Fr 
moeeo jist the crogram: 
Piucteec ol lecmc/e 
[Moylo execute the oronaram: 
Silex C7 e 
meerooram l1istinae: 
Vieeoorent aot OOUGHOL. OUUOUG 5,00014635, 
POSS, CUO S010, 0006014, 
OCG 05070014060,0050060, 
(Oe Gta 0060500, 14G500), 
Mesoyi lao re Ooo Lan, 
COS 0G0, 0050050 ,00 14050, 
Poe Oreo oOUe,0 005006, 
OOO 5.0 0 Gal. 1-0 40 1} 


VWitmneace met) st O010Uc OU 0100500,0140300, 
J906U140,0060060,00350060, 
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9014030,0014014,0000014, 
0003906,00039035,0001403, 
00901403,0001400,0003006, 
0006014,900009030,9014030, 
00300600,00450140,0060140, 
0140300,01496200,91900200}; 


main() 

eoamiewi by 7 imi tal ize 

Gourore Gi 7m ecolortc); //colors 
Worstatloaren, Hoe 1) 6 poU.0)> 7/7 OU Colt 
Paatatrneoaren,46,600.0,60.-0);7 //outout 

} a 
The function "tadata" allows the user to ‘pavnt 

mortions "cnmeeolyiym ct — the screen by adjusting to the next 


meuinm when Screen overflow occurs. The user neeo not worry 


memeome adoincg off tre oottom of the screen. 
b. PROGRAM 12 


ipicmerOgroan Shows the reset action of the func- 
Meme tdata'. Data 1s passed to the routine that 1s much too 
memento be disolayved in a sinale calumn, thus it opaints to 
meremrvoant. The tmase crawn 18 a dotted line. 
moto use csc000 tyne; 
POCUNeere se 0) c/r 
peooMOEU: Student ¢/r 
SGn fom tek C7 - 
Meto list the oroagram: 
is tarec. Plc oGnc/ 
(3)To execute the croaramn: 
Belen ku C76 
Bio-rocram Jistinc: 
Mme es tl 500). ; 


main() 
(Urey es ramtek(), /7inrtialize 
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Ventral ize array *7 

Pome =07 1550041 + +) 

fest ia] = O17 

Gouloetui)s colorte), //7colors 

Moateactest,o07, 10.0,40.0)7 

} 
The user should now possess tne skills required 

for processing the vast majority of his transverse data ap- 


mmpcations. Ihe next Section wal) J91scuss some of the 


Seecifics of the moce for more advanced applications. 


Pee POVANCED METRODS 


The user who desires to execute some orocess that re= 
mueeres more fiexibility $nanm orovidqed in the previous secm> 
tion will have to agrop down one level in the support package 
to the more fundamental functions for processing transverse 
Meta. !he most fundamental function in the supsort package, 
in relation to transverse data, is “data(name,bytes)". The 
"data" routine simoly sends raw data to the PATEK from the 


maay mame” for the specified numoer of "tytes". 


The user must, at this levels ve resconsible for setting 
the mode (see "setmode"), establishing the current operating 
Bowmt (see strtxy"), and orovidina his own oroarammatic cone 
meol. The data definition process 185 the same as discussed 


Meme BASIC USER GUICELINES section. 


Mme control flaqs that are apolicable in the transverse 
data mode are: 


INOCEXED ADDRESSING 


yO 7 





REVERSE BACKGROUND 
SOOITIVE WRITE 


DOUBLE WIDTH 


The user must select all of his flags and frovige the 
mmmnanism for their imolementation. Comolicated transverse 
Mice abolications require much attention to detail for suc: 
mess. For more soecifics the user is encouraged to peruse 


mm@eeeAMTEK Proarammine Manual (1), in the Lab. 


Loe 





Tx. RASTER DATA MODE 


The Raster data mode, except for the direction of the 
writing, is like the Transverse data modae. The Raster data 
mode writes across the screen vice down the screen. The 
mmr y of this moce 1s that it allows the uSer to effi- 


ciently draw irregular imaces of various shapes and sizes. 


Mine very nature cf user aoclications for this tyoe of 
processing dictates that it te utilized at a lower level 
than previous data noces. Tne user mav acefine and draw any 
image that he can conceive. The user muster however, provide 


Srp rogrammatic control himself, as nothing 1s assumed. 


ime aoolicable ccertrol flags in this mode are: 
MeeEAED ADCRPESSING (see"index") 

BEVERSE GACKGROUNO (see"nkarnad" ) 

POOITIVE “RITE (see“writon") 


PEUBLEWIDIH (see"“size") 


The user shoula recall from previous chapters that to 
Blace the RAMTEK in a particular mode of operation the "seto- 
moae’ Software suprort function is utilized. To olace the 
Meer in the Raster cata nove a call of the form 

setroanelde,s,y); 


would ne issued. The araument y cqetermines iat orevious 


flags are Comme rscaveces tf Y1S a ene (1), then all prior 
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flaqs are saved; if zero (0), then all flaqs are reset to 


mee default values. 


Micmticerey nor 7s "um tamiliar with the oqeneration Onn the 
octal data codes that define an image should review the sec- 
Mmmame on !ransverse data. Ihre octal data form is recommended 


mor it's simplicity. 


ine sSottware SuGcOort function “date” is used to tran- 
meme the raw data tc the RAMTEK for display. A call of tne 
form 
Gata <ay) 


meuses ‘y" bytes of cata to be passed to the RAMTEK from ar- 


mine tollowing samole proaqram is provided to assist the 
user in developina his exrertise tn the use of the Raster 


data moae: 


A. PROGRAM 13 


This program 1S cesianen to show the user a specific use 
Bee the Raster data mode. The proaram draws a set of inter 
meena |ines much like a cgrig system or data record. The 
versatility of the Paster aata moce is only restricted vy 
the users imagination. 
Mm 'o use csc090 tyoe: 
Me Ghitimese0 00 —¢/r 


PASSwCPD: stucent csr 





eq famtek ¢7r 

eeio list the program: 
ihicte cr Ol o.c 

Pelco execute the program: 
Sorex Gf 

4H. Program Listing 


/zx Define a horizontal line */ 

Mme eC ciwta OL sarge pO le Tie OLIT 777 OL TT 77, 
Om cme yy pte POLIT TFT TZ OLS a7 7s 
Ore eT tO lea ig OL PT PP ep DIT TI Ti, 
Oli Teel CL eon 717i} se 

/xDefine vertical searents*/ 

Cveieie lam ola) O00 So 5s lo, 0 5, 05,05705,05705,05705, 

Oro ers 0 50 Oo, SYS 

main() 

{int i,j? float sx,syr //aeciare variables 
Su) 160507 “sy = 150.0; 
ramtek(); //initialize system 
Sorore(/ Jar 77esteblish Color table 
setnode(c,0); //establish raster node 
color(2): //select color 
Aemeen unos, O40. 0,040.0); 7/CAMEMSION screen 
/* 
COs tee ere Or CONTR CL 
x / 
for) =07 )}<l¢e; ;++) 

{Stetxy(sxr,sy), 7/establish start point 

sy = sy - ls //decrement y 

Sawa Grmn oo): 

Peyote Pe CUR “x7 

fon cCl= 07 \< 157 1+) 

{datal(div,36) //send aata 


SV = Sy = l, 
} 
Sy = sy ¢+ ll; 
} 
datalln, 436); 


} 
The user should now oossess the requirea skills to 
Memerroo his Own soecial tnaces as reauired. For further in- 
mormation on this mode the user 18 encouraged to read the 


MrmenK Programmers Manual [11 in the Lab. 





eet mer x pala MODE 


This mode writes data to the RAMTEK screen in the same 
manner as the Raster data moder exceot that it allows tne 
user to define the color of each oixel] as it 1s “Oailnted. 
Bees third dimension of calor does have Some overhead asso 
Seated with itr in that now the user must define the color. 
Mmmemecolior definition requires four (4) bitS Der pixel vice 
meet!) bit oer pixel in the other two dgata modes. [The im= 
pact on the user 1S that where one Gata word describes six 
teen (16) oixels in either Raster or Transverse data, Is 


Omiy cescribes four (4) oixels in the Complex data mode. 


[men OOV1louS Oemefit of this mode is that the color of 
mmeees May be modified on a oixel bv oixel cassis. The four 
Memos required to define a color allow the user to address 
aayeeonme of fifteen (15) colors in the current color Icok=-up 
table. The user must construct his data words now using 
mmery coded decimal as an addea steno orior to converting to 


metal. 


The color definition of each oixel must oe done by the 
user, then oassed to tn2 software supoort programmatically. 
Mars color definition reouires the use of UA-oit binary 
Groups (called binary coged decimal). [hese grouos are com- 


Sined into loxrnit cinary patterns, then converted (ov 3=bit 





Meouios) to octs!l. Sucpose the user wishes to define a word 
Mmmm selects four (4) otxels and colors them according to 
the colors one,vfour,seven and eleven of the current color 
looksup taole. To accomplish this task he must convert the 
desired color entries (1,4,7,11) to binary codea decimal 


form as Shown below: 


DECIMAL Sar y CODER DECIMAL 
1 OOO 
ij 0100 
7 Oi 
ial oa! 


The binary coged decimal numners are then combined into one 
Seemery word. For the above examole this number would be: 

On eee OO lik Bval f 
moses inary number must then be transformed into an octal 
reoresentation as discussed in the chaoter on Transverse dan 
Bae ihe octal reoresentation for this example would be 
Meme l/ Ss. The user must cerform this data transformation hin-= 


self. 


Once the data words are orooerly defined, the user need 
only piace the RAMTEK in the Comolex mode with a call of the 
form 

setmode(3,f); 
mene ff determines if orevicus control flags are to ode 
Saved or destroyed (f=l1 save ; f=0 destroy). Having esta 
blished the mode of oreration the information is now passed 


memeome RAMTEK with a call of the form 


eles 





Gata Gx o) 7 


Meme causes “n" bytes of Faw data to be passed to the RAM= 


Meme from the array "x". 


mae following contro! flags are applicable while 
operatina in the Comeolex mode: 

MIDEXED ADDRESSING 

REVERSE BACKGROUND 


DOUBLEwWIDTH 


The followine samole crocram is orovided to assist the 
user in ocevelopina exoertise in the use of the Complex data 


mode: 


A. PROGRAM 14 


fers erogram is designed to demonstrate the Complex data 
mode. Its execution causes the entire display screen to ce 
painted with alternatina bands of tne first seven colors in 
moemor table seven. Tne screen is then oartially erasea and a 
@eramoglte witn similar properties is displaved. 
— 
Mero use cs2090 tyoe: 
BOG Varese 00 “C/¢ 
PASSWORD: student c/r : 
cd ramtek c/r 
eeero list program: 
ies ee Cari 4.sc iS 7/Ale 
$.To execute oroaram: 


ee Xe 7 
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ee ncartan (i) Stina 


Mato) tloll, //ceclare array 

main() 
mt? pip ke, float Sx*+,Sv; 
ramtek(); //init system 
setmode(3-,0); //estaolisn mode 
Peele tL Ze GRRAY | */ 
for (istO0r-i<loiei = 1 + 14) 

lee lel eeid= 007 5567 7 

}Cite) =) C1 +3) +0063146; 

peat ea} =00 Se 5c a+ 

Miytol=) lity pau0deloa: 

ete oleae (toy = 00 510552 

VEi tO} =) f4 411) =002e1042; 

Plitle)d =) Coy+15) 0010421; 

} 
Senrermt020,0.0,5470-07c40'.0);7 /7aimension 
Solort in), 7/selecte color table 
eeeoe UT, Sk = U0, Sy = 050; 

/* 
PAINT SCREEN 
x / 
foGtil=0,1sc40;1++) 
(stmtxy (sxsy ); 
diate hws) > 
Sy = sy + ll, 
} 
Peeper aoe PORTION OF SCREEN «/ 
momoe(4050,10.0,690.0,230.0); 
eae = 0©0.07 sy = 20.0; 


moe 100; 

/* 

DRAW TRIANGLE 
/* 


mor (1-=071<1007j;++) 
fetrtxy(sx,sy); 
data(l,«); 


k = k wf, 
Sx = sx + ll, 
Sy = sy + ll, 
} 


screen 





Mime onncte VECTOR “ODE 


meee INTRODUCTION 


The Graohic Vector Moce is used primarily to draw tines 
Or vectors between user-defined end points. It 18 relative- 
Ieeesimole to use ands oy its nature, fits many aoolications. 
myemuser must be aware that exceot in vertical or horizontal 
Murs Noticeable Quantization error or "“stair=casina” ef-= 
fect wil] AOOe SMa MTS eC OReGlibtlion 1S caused by the low line 
resolution (240 sadressabie) versus hiqh element resolution 
(5640) of the system, and by the very nature of the raster 


Scan device. 


Memeo nolC USER GUIDELINES 


/oput the RAMTEK device into this mode requires a call 
mreecme form 
setmode(4,0):; 
where 4 is the definea number for this mode and 0 indicates 
Bete a!!! contro! flaas are to be turned OFF. If the second 


Darameter was 1, all flaas woulga pe jieft as set oreviously. 


flere first two routines oresentéd ocelow actually set tne 
Proper mode themselves CGYeGcaltieG setmode' internally; 
mmemougn, as previously mentioned, the use of Vsetmoce ” in 


meer user's proaram is considered standard practice. These 


“ ie 





meme vector” and “plotin"™. nem SG eaceceotS as ‘carameters 
two sets of virtual screen coordinate nairs and draws a line 
between the two osoints that they define. It's call would apo- 


Bear as follows : 


Vict Oirieclny lsc, Vie) 


The second accepts two equal length arrays of real 
numbers and an integer value to denote that length. lt then 
plots the points described by the correspondina xry values 
and connects eacn successive ooint with a line from tne cre- 
vious one. Thus if two arrays were declared ana initialized 
as follows : 

fPil@aeuroollminbt Gly <2. Spe ee er XM)? 
Mioateavalmin ty 1, Yer Vo, sas ee VO} 7 
meena Subroutine call of the form 
Ollotlimn (ox, oVv,m) >: 
would correlate the rescective values from the two arrays 


mmemorot the coints with connecting lines. 


Another routine which actually sets the proper mode by 
itsel f fone winlen mrant Be utils z2ed iP conjunction with 
meepo-i9”. This is the "axis" routine. Ags imolied by its 
name, this subroutine Graws a coordinate axis on the screen 
according to the two real numoers it accents aS parameters. 
It woulc be called as follows : 

axaistx;,y)> 
where x and y renoresent the desired virtual screen values 


meme the intersection of tne axes. 





C. ADVANCED METHODS 


At the next level down in the structure of the software, 
there are several ASUGITReS whem are Pighliy functional in 
this system. The first of these is the crocedure for estab- 
Myshina a new Current Operatina Position (COP). To reiterate 
its usage, a call of the form 

Stmexy (x;y)? 
where x and y are real numoers, would estaclisn the COP at 
mmete Virtual screen location. From tnere, a vector could oe 
meawn to another point by utilizing either the "“pooint" or 
Mmeowmtr routines in this node. A call of the form 

BOint (x,V); 
with the parameters recresentine the x ana y values for the 
@esrred pointer woulo draw a vector from the COP tc that 
pOINt ana estanlish the CUP at the new coint. (Curless the 


fmexed point flag was GC?!) 


mmesimilar circumstances, a call to 
SO1mer Coxe av): 


mod Craw a vector from tne COP to a ooirt ‘relative" to 
meee COP as determined by the "“chanae” values passed as 
parameters. Here again the COP would be established at the 


newly calculated ooint unless the fixed doint flag was ON. 


memmemtionedc in “Contro)] Moges and Fiaqs" (Chac IV), the 
MmmeeageDOoint flag is turneo ON and OFF by a call to 
fiom de) 7 


where f is Given the value | to turn ON tne (aq -OF tne 


Nee, 





ere 0 to turn OFF the flac. 


Mmfeethis flag is ON, a call to "strtxy" establishes a 
mpxed ooint from eee all suosequent vectors will be drawn 
Mmereris to “point” or “soointr". In effect, it freezes the 
miirersuntil the occurrence of another "strtxy" command or un- 


mmr the flag is turnec OFF. 


The user snould be aware that each time the fixed point 
Meo is turned ON, after having been OFF, a new “Sstrtxy" 
meme 1s REQUIRED to estahlish the desireag fixed position. 
Mme tisq cannot be simoly toaaqgled ON ana OFF amidst a series 


Mmmeoagint’ and/or "“cointr" callss without erratic results. 


Memer flags whitch affect the ooeration of subroutines tn 
this mode are the Indexed 4adressing flaq, which was ex 
eeimed in "Virtual ccreen Adcressing", ang the Reverse 


Seer ound flag, discusseq in "Cortrol Modes and Flags". 
ie PROGRAM 15 


The sample croagram listed below 1s available in the 
meeevv0 - ramtek" directory to illustrate a variety of the 
described routines. Selective delays have been emoloyed in 
the program to allow the viewer to notice the following 3: 

Mmeecme chance of opackGround color when "“colort(/7)" its 
executed (necause the "ramtek" routine initializes to 
eoior tanle 0); 

meric efficrency of “olotIin" tn drawirg the first three 


Sides of the star; 





eGR emUSe OTe COlmtr to draw the fourth side relative 
tor tie’ third, 

Seethie use of “vector” to draw the final side; 

Se the use of the fixed point method for drawing lines 
from the center to the extreme points of the star, 


Peta DO1mt' anc “oointr’ « 


The user should realize that "“pnlotin" establishes 
Mmeemown initial COrF at the first ooint ana leaves the COP 
Memeryteo at the last coint that it olots. He Shouvlia also be 
aware of the location of tne COP before and after each of 
Mmaemother disolav routines are called. Notice that “strtxy" 
1S used only once -- immediately after turning on the fixed 


eormt flag. 


Pmestvaure disolayecd Gy this orogram iilustrates 
dramatically tne "Stave-casing ‘effect Emagt —sOCCUTrS when 
drawing lines at various angles on the screen. The user may 
meeoemotice that a horizontal line is slightly ‘fatter’ than 
a vertical one cue to the afore-mentioned difference between 
line resolution and element resolution in this system. 

eto use the cscV00 directory ;: 

MmOGtN= cse€000 ¢/r 

PASSWORD: stucent C7 

Ge Gamtek c¢/Fr 

eee} Oo fist the ercaram ; 
mist) —-c jolS.¢ Gran 


e/ Tt 
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Ce 


oe 


To execute the oprogram : 
el > x CVG 
The listing follows 3 
moat oc 4) 4-450, 0.0,8.0,-°60.5)}; //declare array 
moat oY l4) {(=6.90,76.5,=-6.0,2.0}; v7 " q 
mre on a; (7/O3PC hare actay length 
main() 
{int 17 
ramtek(); //ocven the device 
screen(-10.0,710.0,10.0,10.0)7% //set Screen Size 
sleenpl(e2); //oause 
Covorre( sy); Vrselectecohor table / 
sleep(2); //oause 
€olor (5) 7 Se ieet coor. > 
setnode(4,9); l/7# Set Geaonie Vector mode 
Sreoulmcox,OVecn) + (/(SRGteene aCtray Points 
sleeon(2); //oause 
Sonmur (| Se0y 0.0), J/OTaAW lime relative to CUP 
sleep(2); //oause 
Vector lO. I7e-.07 7-0. 0,-6.0); Par aws With “Yoo tor” 
sleep(2); //oause 
Goror (lL); Aeselect color | 
fiexOet Cl) > 2 aerate tT ixed oo1mt flac 
Stmexy (0.0, 0.0);3 JOSOtmStartinoscoint (COP) 
Ponmmenconnes0 ie //Graw first line relative to COP 
sleeo(e); //dnause . 
Hoe (=U; 4 <4; yet ) //Oraw renaining points 
Crome ex Wl eomyl rl) // from fixed COP 
sleeote2); 
} 
} 


es 





Wetweeorere ite -EOt MOOE 


mee LNIRODUCTION 


fine orimary function of the graphic plot mode is to gene 
mate the display of a nistogram style olot. In effect, 
this means to shade or color the area oetween a selected x 
meevs and a line defined by usere=generated points. This shac~ 
mois actually accomplished ov drawing a series of vertical 
memes edjacent to each other. The software that accomplishes 
this is built arouna a RAMTEK hardware feature in this mode 
which automatically increments the element address ty one 
after each line 1s drawn. Tnus after the starting element 
has been estaolisnecd, each successive element (oroceedina 
meet o riaht) 1s individually addressed, ita | the £1 ma: } 
point is reached. As eacn element 1s adoressedcr a vertical 
line 1S drawn from a cres-selected common line or ‘x axis' to 
meme proper tine address or y value. Tne most obvious arcli-= 
meme 1s Olotting a 'function' and shading the erea between 


meee TUNCtIon' and a certain x axisSe 


Bec 





Sema oLC USER GUIDELINES 


bo select the ararhic olot mode the user should make a 
subroutine call of the form 
setmode(5,0); 
mere 5 is the definec number for this mode and 0 indicates 
meat ali control flags are to be turnea OFF. [If a 1 were in 
mms ocosition, all> control flacs would be left as set previe- 


ously. 


mets mode 1S? in effect, imolemented in one routine 
Sealed j‘“oloth”. fhis routine olots a set of xry coordinate 
memes, as did “plotin”" in the previous chaoter, ana then 
Shades the area "under the curve’ as gescribeda above. As 
femeeee DlOtin’, the “oloth" routine requires two equal length 
arrays of real numbers that ABER RTEE thew fUmetion to ce 
plotted, and an tnteser value tnat denotes the length of tne 
arrays. It also requires, as a fourth oarameter, the real y 
meue (€reoresentina the x axis) from which the olot should 
memes Thus a call to this routine would be as follows : 
ploth(ox-,oys,n,base); 
mmere “ox” and"cv" are the names of the arrays, n is the 
length of the arravs, ard "base" is the desired base of the 


mrstoaram clot. For oroper results, the x values must oe ar- 


mamagec 1M ascendqina croer in the array. 


a5 


' 
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1. PROGRAM 16 


This samole orogram, available for execution in the 
mesecU00 - ramtek" directory, wt!l!] illustrate the histogran 
meee Clot achteved oy "“oloth”". Prior to eplottina the histo- 
gram, a set of axes, that will coincide with the center of 
the plot, are oositioned on the Screen. Tne user should note 
mmet the histogram overlaos and wines out these axes In tne 
mrees that are commor to tne two ‘displays. I[If the "axis" 
mae head been olacec after the "oloth” calls this condition 
would be reversed. Tne routine “olotin" is also called with 
the same data to ocint out tne relationshio between these 
two routines. (Note : The “setmode" calls could nave teen 
mmmccec, since both "“pnloth” and "olotin" set their own ree 
aquired modes internally.) 

meio use the cs2e000 girectory ; 

Poo) e¢se000 Car 

BEOSMORD? Sstucent Grae 

cd ramtex«k eo 

peeet'o tist the orcgram ; 
ins C=C POO. C ete 
esr 

See 'O execute the procram ; 
e160. x Ce 

Beene listing follows : 


mmeoat ox(40) ft 


56 
4.0 
sro 0) 
0.0 
m0 


~ 


mroat py[40) { 





— 


int 


om 40; 


moat pbase 5.0; 


main() 
{ramtek(); 


screen(0.0,0. 


eqiort(/); 
eolort(l), 


sleeo(3); 
Color(s); 
setmode(5,0); 


BPhetnlox,oy-.an,cbase), 


sleeo(3); 
eelor (>); 
setmode(4,0); 


eelotilmlox,OV,En) > 


oe 


The use of the araohic clot mode for any 


operations than 
wil] 


ming Manual (1). 


BSDVANCED METHODS 


can be accomolishea 


Fequire the user to consult 


//open the device 
Oye 0, 00); VySset Cimensi ons 
V7EGCVOn tad le, / 


LEG Og 
axi1s(9.95,5.0); 


// draw 
//oause 
LSEOVOR 7 
//select gracnic olot mode 
(JOMOU hist ogra 


ax eS 


//oause 


FAI EMAMDAE (COLOT 


//chanqe mode 


LP OVGew tne function ' 


more detailed 


Syetne, clots’ rPoutine 


the RAMTEK Gx-100 Program- 
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Cee orormlt Cle TE olan MODE 


A, INTRODUCTION 


The graphic cartesian mode is used to draw solid rectan= 
gles on tne RAMTEK screen. Tnese rectanales must be defined 
Met wo diagonally opoosite corner cointsr the second of 
merenm becomes the new COP after comoleticn. Since these 
rectangles may one disclaved ia samy. color, the user, by 
choosina the background color, can effectively use this mode 


moreselective erasure of rectangular areas. 


SeeeeeAolC USER GUIDELINES 


Selection of tne graohic cartesian mode can be achieved 
eee Cal! of the form 
setmode(6,f); 
where 6 is the definea number for this mode. The parameter 
mie smould have the value 0 to turn OFF all control flaaqs, 
or the value 1 to leave all flacs as they were set orior to 


mors cail. 


The simolest imolementaticn of this tode is through the 
mock’ routine. The user must first have selected his 
meromred color by using the "color" routine. Tnen the call! to 
"Dlock", which reauires four real numoer ocarametersr woulda 


appear as foliows : 


reo 





PleemOmipy ly xcer Vic); 
where the two respective coordinate pairs define two diago- 
mely opocosite corners of the desired block to be displayed. 
The resulting COP will be located at the point (xe,ry2), the 


mrt to be transmittec to the FAMTEK,. 


ire "block routine does out the RAMTEK into the graphic 
Cartesian mode by itself and it also ccees Some fairly ela- 
mmeeace error checking. But a quick scan of the source code 
would ee | that the actual rectangular aisolay 18S agenerat> 
MerssSuIng a ‘“strtxy" call followed ov a "point" call. 
The user 1S, of course, free to utilize these routines also. 


Memmeract, i7 some anolications they are essential. 


mys after selecting the proper mode and color, the user 
could create the same disonlay as the "block" call above ay 
/meeuyna the following two subroutine calls ; 
SGrt cy Ox pny lo Sorat (x2, Vve)- 


messumina the parameter values were the Same as above). 


See OVANCED METHODS 


mmemough the basic results are the Same, a variety of 
approaches are available. Sone users may find the “cointr" 
meat ymne convenient in apelications where relative aacressing 
Becomes easier to ccemoute than acsolute. Thus after using 
Meemeestrtxy” routine to establish an initial COP, the 
Mepeemtr” routine could be called repeatedly (as could 


BeOInt") to aenerate a series of linkec rectangles. 
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Maerewealso may Oe certain acolications in which the ine 
dexed addressing feature is useful. This may be imolemented 
myeethe “index” routine explained in Chapter IV under “Virtus- 


mie ocreen Addressing". 
1. PROGRAM 17 


This sample scrogram is available in the "“csedv00 = 
mute k directory te graonically demonstrate the effect of 
mre seperate routines incurs erode. Ihe user sShoula@ observe 
ome following =: Cela cmuscmotTmmetiggk to Graw a Glock in 
Mmenupoer left gquacrant of the screens (2) the use of 
Mamexy and ij ‘“s0I1nt" to draw a similar nlock in the uprer 
Pight quadrant; (3) the use of relative addressing wnen us- 
Poe SCointr to generate two smal! coxes in the lower right 
Quadrant; (4) the use of indexed addressing to cxDosition 
three small boxes in the lower left quadrant? (5) the 
"selective erasure’ effect achieved oy selecting color 0 and 


Simewing Over cart of the block in the uoner riaht auadrant. 


New assist the user im accessing this orogram the 
following quidelines are provided : 
@e To use the cs2000 directory ; 
LOGIN: cs2000 CF 
PASSNORD: stucent Cir 
cd ramtek C7 
Geel o list the orearam ; 
Minster aG. Oly eC eli r 


c/r 


eG 





Seo }—execute the orogram : 
Olax Cee 


Serre listing follows : 


main() 
{ramtek(); 7/ooem tne device 
screen(0.0,0.0,20.0,20.0)3 //set aimensions 
setmode(6,9); //select grachic cartesian mode 
eolortt(/); //select color table 7 
eoior(l); MeseleGt Color, | 
empoek(5.0,15.0,/7~.0717.0)7 Vaporaw sa O1ock 
sleen(2); //cause 
greet xy(15.0,17.0);3 //festablish new COP 
eemt(i¢’.0,15.0); //adraw a olock 
sleeo(2); //oause 
eolor( 3); /PSelLect. color 3S 
eer txy(1/7.0,/7.0); ffestaci1sn new COP 
sormtr(=-2.0,<-2.0); J/araw relative’ to COP 
soimtr(=e.0,-2.0); i sat “ at mies 
sleep(c); Leas S 
eolor(!); 7 eo (o) game | 


madex(!1,1.0,1.0):? lo index ar rome | l.UG leo } 
pert xy (esc0rc.0); //s3et new COP 


morvmt(4.0,4.0); Vi arav. a © lock 
eolor(5)-; LE Sevect = Color. > 

peer cexy(5.0,5.0); //set new COP 

momime (560,5.0); //araw a olock 
eolort/); V7Selsect color 7 
mmertxy(4.0,4.0); //set new COP 
eoyne(o.0,0.0); Li@mcawoa ic loc« 
sleeo(2); //cause 

maoex(0,0.0,0.0); J/7turn OFF index fiaa 
eolor(0); (/Sel\eGetvoaexgrounc color 


Semeur Say lo. 07 15.0); s// erase” cart of a block 
} 
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Wi ecm Ae te feet] MODE 


meee EN TRODUCTION 


iar s mode involves activatinoa or Tovey Tau tale ms individual 
elements (oixels) on the RAMTEK screen. VWinen ooeratina in 
Mme aJrachic element node the user must cornuter either oro- 
Grammatically or by hand, the virtual screen coordinates of 
each pixel that ne gesires activated. As such, 1tS use may 
may not seem as attractive as some other moges, yet for some 


Seplications this mode may prove extremelv useful. 


Gm AsiC USER GUIDELINES 


The graonic elemert mone may vce selected by a call Such 
as 
setmode(/,f); 
where 7 is the cesicgnated number of tnis mode. the second 
meeeermrecer (f) shoula ce a ‘0’ to turn OFF all contro! flags, 


eome 1' to leave the flaas as they were. 


Myeetts naturer this mode gemands an increased awareness 
of the virtual screen dimensions. The screen may be aimren- 
mmemed tO any size the user desires by a call of the form 3 

screen(xminsyminexnaxrs,ymax); 
which will result im the minimum ccordinate values 


Pepresenting the lower tleft corner of tne screen and the 


ey) 





mexcimum values reoresenting the uncer riaht. There are some 


instances when viewing the screen in its ‘real’ dimensions 


will help. This may be acnievea by usina the "Screen" 
Poutine to set the 640 dy ec 40 dimensions by 
eereen(0.0,0.0,640.0,c40.0). Ine of tne more useful aco) 1 


mmmon routines in this mode is the "plotet” rcutine. This 
procedure, AGE ee DOllotm: “and “plotin” er previous 
chapters, requires as oarameters two equal length arrays of 
real numbers and an integer value definina that length. Thus 
if tne following arrays were declared and initialized : 

dle@ron mom Laln Vx be KC pons «ocr XN se 

fALOotreyiimMl vd, Ver ¥ Sigc 2 oc n YONI + 
then the suoroutine call 

plotot(px,oyen), 


would correlate the n Vollmres st Mom. Ox and oy and ac7 


tivate those flim m Tolial ouxels on the screen according 


mMemtme currently selected color. 


Mme clotet” routine actually nakes a series of calls to 
Bae familiar "“point" Tiny Gre 1 Ge iGatinis) NoOce, Cne ~ OO1nt © 
momcine 1S usea to address individual elements on the 
Sereenr,r not to define the end point of Some vector or block 
drawing orocedure as before. Thus the user may utilize 
Beem: to activate arbitrary ovixels. This can be heloful 
when plottina some function whase valuesS are not known 


beforemhand. (see samcele oroaram below) 





The "pointr"™ routine may also de usec to address some 
element relative to the oreviously adoaoressed element (loca- 
tion of COP). The reverse hackgrouna and indexed agdressing 
flags which were exclained in "Control Modes and Flags" 


(Chap IV) are apolicable to this mode. 


me PROGRAM 16 


The following orcaram, when executed will compute 
ema clot the points alone the circumference cf a circle. At 
mmeesame time, it uses the results of its SIN function com- 
Mmmerations to plot a cortion of a sine curve within the cire- 
mere n1S program 1S 1fn tne "cs2000 *= ramtexk" directory and 
can be accessed as follows : 

meio use the csc000 directory : 

BUGLN, -¢se00) erp 

PASSWORD: stucent Cer 

CO remtek Ge 

meeeO «€©61iSt 6tthe prearam : 
Ist. =o Wo lo sic ey i 
ey i 

Geel O execute the procram : 
018. C7 

Seer he ltistina follows : 

dousle sin(); 

douole cos(); 

float ox; 

float oy; 

Moat or 3.0; Wagan s- “Ot € rec} Ss 

main() 


mrroat i,t, 
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ramtek(); V7 Geen tne device 
sae reen(=5.0,-°5.0,5.0,5.0), //set aimensions 


CONort (7); J/color table 7 
eQror (a Ji L7GONOns 2 . 
setmode(/,0); //select araphic element mode 
Pome OC) = oeeo5l6ée1 = 1 + 0.01) 
(oxen OR © COS (7) + 
t = sini); 
Oy = or * t; 
o0IntlCox,ev); ,roVot che circle 


ite= OO eon t( (1 =—5) 76); ZAOVO’ Sane 


See FOVANCED METHUDS 


The araohic element mode seems best suited for plotting 
a series of ooints that are computed by the apolication pro- 
mmam itself. Depending on the desired display, some projects 
Mmmeceauire the user to pre=commute his data coints might 
be more adaptable to cne of the Data modes. (see Faster and 


Transverse Data Modes) 





My eeeee eV TERK INTERACTIVE KEYSOARD 


The RAMTEK keyboard is software adapted to be utilized 
Pemeam interactive tool by the RAMTEK user. This keyboard 
mrocated in front of the GXxX-1004) is ON when the green 
Setch/liaht Keune mupre rar iagmt commer) 16 Glowing, to ac@- 
Mavate the keydoard when TRE is Clie y agepress the 


eeatch/light. The xeytoard is configured as shown in Figure 


3. 


Referring to Figure 3, the user will rote that there 
meme 1ghty=-nine (89) keys. Each key may have from one (1) to 
three (3) states (ucoercase, lowercase, control). The user 
mass availabie ¢c3/ distinct codes that may be transmitted via 
mmemseyooard, with the ASCII code being utilized for all 
keys. The decinal rerresentation of the actual code returned 


mmomeselecting a particular key is shown in Figure 4. 


The system software has been desianed to allow the user 
TO read keyboard inodout quite easily. The three functions 
Phat altow tne uSer to interact with the keydDoard can opro- 
vide individual ASCII characters, inteaer numbers, or real 


Bemoers deoending on the function utilized. 


meeaddition to reading from the keyboard, the user may 
Mmromerorint back to the RAMTEK screen individual ASCII cnar- 


Memenms as they are reac. The system sueport routine "“out(n)"™ 
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Memmraes this capability €'m is an ASCII] coged character). 
mae function "out(n)" automatically repositions the COP one 


G@haracter to the right to prevent overm-writing. 


ie tUNCtIOom that returns individual ASCII characters 
Mmemeethne user is "retchar()". To read a character from the 
RAMIEK keyboard the user would issue a Sailor the Tors 
Yee petcnan | jz 
nom 


mers will result in "x" hetna assigned the value of the 


selected key. 


Pee PROGRAM 19 


mas Oroaram will reagr, and echo print to the PAMTEK 
screen, characters selected from the RAMTER kevbdoara (NNT 
MmmeoelLECTIONS ARE PRINTABLE). The eprogqram terminates when a 
Bmoe carriage return 18 inout. 
mero Use the csc000 directory: 
MeCii sc sese0U ¢/r 
BaSoMUROs Student c¢/r 
Garirantek “67° 
pelo list the program: 
esis '=—G (C1 onc C7 'r 
Pelco execute the proaram: 
Oe x G/F 
meer mnoaram listing follows: 
Rdefine CR 13 
main() 


{int x; //inteaer variable 
ramtek(); //initialize 
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Solemtleiyumcoror 2), 4/select colors 
Tice wmeamiretemart)) t= €R) //looo 
feotirexy (a0, 50.0), 7/set positon 
out(x); //echo character 
} 

To read an integer from the RAMTEK, the user depends 
Meer ithe system function "“ageti()". To read an integer quan- 
tity from the key board the user issues a call of the form 

Vers rae ty (jy 
The function “aqetif)" recoanizes a carriage return as the 
mmemeof the incut value. To input tne value one hundred the 
Meer woula tyoe (at the RAVTEK keyboard) : 
100 c/r 
A negative one (71) 18S returned limos Cartriages return 1s 


tyered as the fais © Enaracter. teemomtly Valta incuts are 


lowercase numbers; all others are iqnored. 


B. PROGRAM 20 


fjris orooram allows tne user to ineut imteaer values 
from the Keydoard until a carriage return is tyded as the 
Muest character in a new number. The integer value is outout 
memeoie RAMTEK screen for user verification (see “jitoal(x)"). 
ilo use the cs2000 directory: 
Cities cScUU0 c/F 
sootcr DD: Student ¢/r 
edvranmte< ¢c/r 
Peto list the program: 


vst Cc 6ec).c ey 
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SeiO0 execute the orogram: 
oc0.x clr 
ae rogram !'1sting follows: 
Hdefine CR 13 
malin) 
{int ks //inteaer variable 
fambemi)>, ¢/inmitial ize 
Soreness colortc), //select colors 
Himbewtte = geti1()) != ER) 7S loco 
Toe Pex los Uy aS0a0 ), //Set CUP 
fecal). —/Joutout Value 
} 

To read a real number from the RAMTEK keyboard the user 
meets) | 'aetf{)". The user would issue a call of the form 
y = cetf() 
to read a real number. The result woulo be the assiaqnmrent 
Mere al mumoer to the variable "y". The function “getf{()" 
Pecoagnizes acarriage return as the end of the inout Value. 


imry lowercase numbers, e fopme~Oomemtial, “+ or -', anc 


meeeare Valid inouts to the routines al! others are ignored. 


fhe user should now be able to effectively use the Key 
meme as an imteractive tool. Fer soecifics on the functions 


see Apovendix 8. 
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Coe o ec cen PPLETCATLONS ROUTINES 


mee purpose of this chacter 1s to present those 
routines from the software suponort oackaqe which are not an 
meeearal part of any topic discussea earliers, ana which 
would otherwise be omitted. Some of the routines in the sup- 
oort package are merely suborainate oarts of larger routines 
and serve no standealone purvose. These will not oe dis- 
cussed. The routines cresentec here are those that mignt be 


mmmemayeo Dy a user's aoclication croaram. 


Beere 1S only One fFoutine tin the support package tnat 
requires xnowledace of the fact that this device actually has 
Sle rester lines == 480 of which are visible and 3e of which 
Memeo, the botton of the screen. This 1s tne “Scroll” funce- 
mom, which 1s used to make a display tove uP or down by a 
memetarnm Number of real lines. If a oortion of the stisplav is 
Beerolled’' off the too of the screen, it will ‘wrao around’ 
ang reaopear at tne tFtottom (Cand vice versa). Tnus the 3e 
non-vistoble lines that exist off the bottom of the screen 
must ne taken jcumoume Cc Omscicgeration when makimaq use of tnis 
meacure. Ihe subroutine call would acpear as 

Soro cairect yom, numt ines); 
where the carameter "cirection’ must bve either a “"u" for UP 


or a TS ha fe) [e ch eaanGetae “timlime ocaraneter 1S a real 


memoer cgenoting the number of real screen lines the aisplay 
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should be moved. 


In previous chapters, Screen addressing has been 
presented in terms of the virtual screen. There are two 
routines that nap these virtual addresses into. real Cana 
visible) screen lecations for the actual disolay generator. 
Meise are “conve” and "“convi". The “conve" function con-= 
verts the X coordinate into a real screen elenent voosition. 
[mer convi” function converts the Y coordinate into a visi- 
ble real Screen line numoer. The combination of these two 
@ermime an element/liine intersection or pixel. These func- 
tions are used iqateenaity. Dy all the software disolay 
meetines to convert user-defined addresses to real screen 
locations ovoefore cassing these to the RAMTEK buffer for 
display. Inese two orecedures may he employed ov the user 
with individual calls such as 

Geave(<)7 » "conv ly); 
now mon 


where x and y are tne real numoers of the desired virtu- 


meeeSGereen acaress. 


Mmeorcder to cise!ay a Given inteacer value (in the range 
See 5c/6/ to +32767) on the screen, the “itoal™ routine may 
be used. This routine will convert the aiven inteaer carame= 
Sem 1mto its ASCII code and display the aesired integer 
mommuie OM the screen at the COP. The call woula be 
vs ole ile 


where "n°" 1S any valiao integer value. 
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MmicewrsSey the  ttos ftumetionm may be used to displav a 
mal number with no more than nine digits to the left of the 
meuma) ooint and no more thar four digits to the right. 


fens if "x" were a valid real number, the cal} 


ftoa tx), 
would display the decima) reoresentation of Enrart number 
(complete with decimal Sout wometne RAMTEK Screen at the 


mMeeation of the Cur. 


The “out" function takes, aS a sinale parameter, the 
fer = code for any valid character and "“dumes" it to the 
RAMTEK MemeGischlayvecnet cneracter. Since tne ASCII cade for 
the character 1S recuired, this may be acnieved in two ways. 
mumest, the character ray ve enclosed in single quotes within 
Mme subroutine call, sucn as 

OU ae; 
moO diselay the letter xz ore second, if tne user presrdefines 
BeeGharacter, such 4s with 

eEgefine COMMA ()54 

then the cal! 

out (COMMA); 
meomla display a comma at the location of the COP. The x 
Value or element position of the COP is incremented by 7 
EepemientsS to crevent destroying that cnaracter with the next 


Membpe disclayed. (see “Alphanumeric Mode") 


eee rietiy mentioned in the “Alphanumeric Mode", raw 


data 1S cassed ie [e) the RA™MTENX by the "“Gume” routine. This 
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procedure sends a ore=declared number of bytes of data from 
mae software buffer (called "buff")J to the RAMTEK hardware 
buffer. The number of bytes to be saseee ic normally kept in 
"Hytecnt". The address of the next availapnle lacation in 
Serr ”|61S «Keot in a sointer called "ctrouff". Thus, for exe- 
ample, to sena the octal value 060017 to the RAMTEK, the 
mMelOwing instructions would be used : 

soeeourt = UsOgul7, 

Sr reut t tt, 


bvibecmte = Oyvececat + <7 


dumolnuffrbytecnt)-; 


Memoperate at this level in the RAMTEK environment, tne 
wser should familiarize himself with the RAMTEK GxX-100 Proe 
gramming Manual [1] and tne RAMTEK software source code 


meat lable in tne Lab. 
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APPENDIX & 


Ogee our Pear FUNCTION DESCRIPTIONS 


This Apoendix contains the descriptions of the user n= 
terface routines in the format that 1s followed tn the docu- 
mentation of the UNIX operating system tn the Naval Postgra- 


mmrte ochoo!| Comcuter Laboratory. 
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ADOFF 
adqon 
ALPHA 
axis 
BKON 
BKOFF 
Bkrnd 
blank 
BLK 
Biock 
box 
bracket 
buf 
Dia ft ft 

ou 1 lasw 
Sy tb | 
oytecnt 
Cc 

enc o | 
chnge 
errno | d 
err tb) 
code 
codeit 
coke 
Sorin t 
Golor 
eo1ort 
molortb) 
colsw 
comb 
CUMMA 
COMPD 
conve 
ony Vy | 
CODY 

Ck 
eursor 
data 
datao 
dolwia 
ese 
esoycthd! 
dump 
einst 


RESERVED wORDS 


enthola 
ecagel 
ecagec 
entnold 
erase 
Eko 
Milder ¢ 

i ee 
fname 

ne 

ected 
FROWN 
ftcoa 
getf 

ae 64 
getnum 
qgetsw 
getxy 
GRAPHCRI 
GRAPHEL™ 
GRAPHVEC 
head 
headotr 
heat 
amelie *2 
holdy 
index 
yaotrs 
1eStc 


instl-inst80 


inter 
met a5 
int 6v 
eters] 
itoal 
Gs iS 
1 XON 
LCM 
lemholdad 
KER 
DEX 
Liesl 
ine 2 
Lik 
ey. 
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eae | 

ey ee 

LTA 

Babe, 
heoe 

L XD 

Nax Sw 
moreinst 
TSW 
nQenti?7 
Geuh | 
okene 
pause 
OTe k 

Ba Ole t 
Silke t iin 
oe eters 
So1nt 
Solnt tc 
moe 1 
Seoee 
Cinoc > 
oroc4 
SEoc>) 
Srsot 

Oc rcoun f 
Sg CuUO 
AGCtr 
qotrl 
Oi g 
quest 
al 
ramtek 
RASTER D 
reaim 
resclir 
retchnear 
Savelr 
Savstat 
scissor 
5 GR 
screen 
Sema 
S Bie 
sSetmode 


setup 
Sixpak 
size 
Sk1O 
oes OH 
status 
Sitter ore 
strtxy 
Swary 
symbo | 
Syst ou 
tabcolor 
tabddim 
tandinit 
taosw 
Cou whe 
tdata 
terse 
texto 
tito. 
TRANSD 
triple 


WIOOFF 
DON 
writon 
Kaxis 
etna fala 
xmax 
xSwitcn 
yaxis 
yaxisf 
ymin 
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Mayercl 1977 


aS = Oraw coordinate axis 


axis 
NAME: 
SYNOPSIS: 
ax ts (x+y 
float x, 


DESCRIPTIUN: 


Oroawsea cartesian coordinate x and v acs 
with center at usercsdefined screen coordinate 


screen 
Gey) « 


The operation is totally inaevendent at any 


) 
ve 


mode issued oreviously. 


The COP 


isleft at (max x-value,y). 


Normal return 1S 2ero. 


MeAGNOSTICS: 
Returned 
the use 


TIIMGttGste SG MC OOrtTOn) of the axis 
-sefinec screen. 
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coe 
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obkrnd May e1 1977 okrnd 


NAME $ 
BeEmMmae= Change reverse background flag 


SYNOPSIS: 
bkrnd(q) 
Int a, 


MeocCRIPIION;: 
Ht G iS Zero, the reverse bacxaround flag in the con- 
} t 


eel mode 1S set to zero, 1.€-. UPceci Ot t 


Tf @ 18 equal to ones, the reverse nackground yee! mn 
mie GcOMmtrol Moce 1S set to one, 1.6. turned on. 


Normal return is zero. 


meaGNOSTICS: 
meturmmed -l indicates the eassecd integer a 1G.) oot 
equal GO Zero onm Ore. 


ees 





Glock 


NAME 


are 1 boy 7 block 


poco drowesolia clock 


SYNOPSIS: 


eprock(xl,yl,xerye) 
miecat xl,yirxers,ye:; 


BEeoCRIFTIUN: 


MAC se tl Gecko 1S erann with oopcosite corners as de- 
Prumed boy useredefined screen coordinates (xi-ryl) ana 
(xerye). 


fee COP 46 left at (xv2e,ye). The operation is indeper- 
Sem @motmamy Noeete 1sSUeqc oOreviousiy but is sensitive to 


all flaas annlicable to Graphic Cartesian mone. 


Normal return 1S zero. 


DIAGNOSTICS: 


Zep mMeao —L ImCcicates the block Cam not be oarawn = on 
the userw-definec screen. 


See ALSO: 


meaext), obx<rmal)+. dobiwiol) 
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buildsw Waivecel. 1977 buildsw 


NAMES 
piniecw = purta Poaqical Switches on the tabdlet 


SYNOPSIS: 
mir) OSw(Sw,rxhsexlryhsvl) 
float xhexlis,yhryl; 
int Sw, 


PeocRIPTIUN: 

Allows tne user te Gera me tae vidue | Genre a 
mowitemes on the Vector General fTaclet by oassing the 
following oarameters 3: 

leuser's logical switch number (Cinteger) 

emhiah x value (real) 

S-low x value (real) 

4He-high y value (real) 

Slow y value (real) 
Beeenus “ce yming a Selection box anc assianing it tne 
fecired rumber. “Maximum Humoer of Switches is eS. 


DIAGNOSTICS: - 
Normal return is the switch number. 
Returned -1 indicates attemet to create more than 25 
Switches. | 


mee ALSO: 
Sixpak(); tabdsw(); 
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chnge tavere | oy 7 chnge 


NAME: 
enmge = change color table entry 


SYNOPSIS: 
eumcoce(nurbrentry,cont ) 
ia emumos, entry, COnt, 


DESCRIPTION: 
Mmarenigesc tne Specirivea entry am the indicated color 
tacle to the casseq naratreter cont. trrvole() “should 
SemuGeo to Out Cont Imto the proper form. 


numb 1S the tahle number in which the entry 15 to be 
Cnanged. entry 1s Ene Semtcy Imuqboer to (be chances. 
cont is the integer twelve bit code which is loaded in 
the specified entry. 


Normal return i$ zero. 
BEA GNOSTICS: 
All errors are itraqicated by negative returned values. 


fhe error values and their meaninas are as follows: 


=] Indicates rumb 1s less than four or greater than 
seventeen. 


22 Indicates entry is negative or areater tnan fif- 
teen. 
mee Also0: 
meiple() 
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clrtol Mavyeel) 1977 clrtb] 


NAME? 
Meecirtb! - toacg color table 


SYNOPSIS: 
eer tol (nm, name) 
Int Ne *Name,; 


DESCRIPTION: 
meade color tatple mumoer n with the codes containea in 
the array oointed to hy Name, 


The array 18S an integer array containing sixteen ine 
tesgers which reoresent tne octal code of the color 
table entries tetween zero and fifteen. The array is 
assumeaq to be declared sixteen words in Jengcth. 


Nn 1S an integer value which ranaes from four to sevene- 
teen. 


The color tables from zero to four are system defined 
tables. tnerecomt ara tne co! lowing: 
Memicole 0 —-"Futteen shaces of Grey. 
fables Vo = "Fitteen shades of Clue. 
Table 2 = Fifteen shades of green. 
Table 43 Fifteen shades of red. 


Mmemene wser desires to mooify a system table see 
mmter(). 


Normal return 18 zero. 


DIAGNOSTICS: 
metturneca -!] indicates the oassed inteaer on 1s veces 
than four or greater than Seventeen. 


wee ALSO: 
triple() 
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meolor May en io7/ color 


NAME s 
Goror = select color 


SYNOPSIS: 
ao lor (s) 
vac S% 


mmeocRIPTION: 
[mio oscseoOulmtearcr Ss 1S fhe number of the desired en= 


tony mn Brcmecurtmenmt color =taole. lhe color located in 
@eae emtry will be used for 4!) subsequent entities 
SeESoesyvec aunt tio Git tercent color is issued. 


S 1$ netween zero ano fifteen. 
Normal return 18 2°fro0. 


Pre GNOSIICS: 
Returnedq -l indicates the passed integer s is negative 


or oreater than fifteen. 


wee ALSO: 
chnae() 





eolort Mavewc) 1977 Color 


NAME s 
aolortes senecet a:sollay color table 


SYNOPSIS: 
Solort Ct) 
wnt ot 


DESCRIPTION: 
Tne ocassed parameter t 1s the number of the “color 
fenle that 16 serrt to the KAMTEK cevice for disolay. 


t 31S between zero and severteen. 


\ 


Normal return 1S z2ero. 


PPAGNOSTICS: 
Returnea -l1 indicates the nassegqg inteaer t 18 negative 


or areater than seventeen. 


See ALSO: 
ereto | () 


les 





conve 


NAME: 
Memconve = Convert an 


SYNOPSIS: 
eomvye (x ) 
mroat x; 


MeoCRIPTION: 
Momverts se virtual 
ico a real Ste Ir 
OH01Int Darameter mu 
me CUrrent virtua 


PPAGNOUSTICS: 
| keturns the nutter 
feion . 


eee ALSO: 
convl(); 


May 21 19/77 conve 


revue to am elememt location 


screen xy*Jirension value or adoress 
een element cositian. The floating 
St te a valid address component tor 
] Screen soace. 


of the real Se reen element posie 
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conv] Woy ecimsl oly conv] 


NAME s 
Goavl= cComvert a ¥v Value to ae real screen line number 


SyNOPSIS: 
convl(y) 
float y; 


G@iocRIPI LON: 
Minverteses vViktual Screen vedirmension value into a 
real Screen line number. Tne floating point parameter 
must of avalicd address comcoonent for the current vir 
tual screen soace. 


MeecNOSlics: 
Returns tne numcoer of the real screen line. 


eee ALSO: 
conve(); 


obs. 





eursor May e221 1977 


NAM 


ifr 


SYNOPSIS: 
eursor(); 
extern float tx,ty-?, 


MmeoeriPTiIONns 


CUESOT 


GircoOGpme SGtiwoare cursor (V¥.6. tablet driven) 


iS POUt+mMe ClacesS 8 CUrFSOF om the Screen of the RAVe 


feo im color 15 of the cUrrert color table. 


ine E€CUrsor 


msmcestructive in thot 1t erases everything that as 
ceasses over. homer oleot tne "Gursor 1S via the VECTOR 


GENERAL tablet. tihen the pen 1s deoressea 


disaocears anc exits. Pme x and y 
cen/cursor tocation are saved in tx ana 
globa! to the user ocrogoram) for tne user. 


Peo NOSTICS: 
none 


cae ALSO: 
memocet) » Getxy() +» tabdin() , tadinit() 


axe 


td 


the Cursor 


values of the 
ty 


(must be 


screen() 


data May 21 1977 data: 


NAME: 
data - disolay raw aata 


SYNOPSIS: 
data(name,|) 
int *name, |; 


MeoCRIPTION: 
Memtne faw date oassed in the linear array pointed to by 
meme Vs mea isolavec Om the PFANTEK  accoraing to the 
Gurrent contro!) mode. 


limes tme lenath of the array in bytes! 
Normal return is zero. 


PeeeoNOSTIcs: 
Returned wl indicates the casseaq integer 1 is neaative 


Cre cero. 


mee ALSO: 
sseroutr(), IIttr{) 





dolwid Mave lee oT 7 


NAME ¢ 


- 


dolwiag = charae dounle wiath flag 


SYNUPSIS: 
Gistwialx) 
Ae Meer 


MeoCRIPTION: 
ir x 1S eEacual to zero, the double width flag 


SGemtror moGge 315 Set to zero, 1.8. turned off. 


Mex 1S Equal to one, the gqouble wiath flag 
Gomtro! mode 1S Set to oner 1.€. turneac on. 


Normal return jis zero. 


PAGNOSTICS: 
Peturned -1 inoicates the passed integer «x 


equal to zero or one. 


SEE ALSO: 
size() 
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diso anya i) tod G1isp 


NAME 3 
mse olselay a selected’ color table (long form) 


ervUPSIS: 
disp (n); 
mat N+ 


MeoeriPItion: 

| ine wectlor table denoted by the inteqer oarameter n 

Mommy splavec 9m tne sereen, a1onG with the octal code 
reauirea to generate each entry. 


SEE ALSO: 
Misevetb! () 


iS 





dsoycthb| May el 1977 dspyctn] 


NAME 3: 
dspycto] ~ aisolay a selected color tanrle 


SryvurPSIS: 
misoyctp i (j); 
int je 


Meer tT PTiON: 
Mm The color table denoted by the integer psaramreter ‘'j' 
ome | SOUsyed om the k5Y TEX. BackGround color is entry 
Seon SDley Color is ertry 15. 


mee ALSO: 
dGisp( ) 
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dump Mieyoce eri 7 7 dumo 


NAME: 
Bemcume = Ssema Paw data to the RAMTEK 


SeewUPSIS: 
dumolbouff,bytes); 
char xbuff7 
int bytes, 


MEocrRIPTION: 

; Mertes raw Gata te tme RAMIEK instruction tuffer. This 
Popeye als tor low level contro! of tne KAKTEK and is 
very restrictive. Ine raw data 1S interoreted accordu- 
Ing to the mode and flaas set within the device. 


PeaGNOSTICS: 
none 


gee ALSO: 
write() », RPAMTEK PROGGRPAMMERS MANUAL 


lefer | 





erase clayeee los 7 erase 


NAME: 
Meeerase - erases the screen 


SYNOPSIS: 
erase() 


BeockIPTION: 


MmnemrnaeteEK seresn 16 erased to the current Gecko round 


color (ie, tne state of the 


Mord 


reverse background flag). 





fixpt 


NAME > 


Mayec ) 1977 le eke 


meat mM Gnemoe tf) xeqd Cornt Fflaq Im control mode 


eeeNOPSIS: 


firxot (x) 
Mae xs 


BeockIPTION: 


impex 1S eaual to zero, the fixed coint flag aa the 
Gomera! Mode 1S set tc zero, 1.6. turned off. 


fatx 15 eGual £o one, the fixveo seoint flag in the con- 
Proll mode is set t9 one, 1.@€. turnec on. 
Pemmimatulsomly tm Graphic Vector or Graohic Plot 
mode. In Graohic Vector noce it causes all sunsecuent 
vectors to oe drawn from a common noint as issued by a 
Subsequent (or: the last orevious) strtxy(). In Graphic 
Plot moce this flan 18 used to acnieve the histogram 
Maer eGnplot wot “elothrtl)". 


Normal return is zero. 


DIAGNOSTICS: 


SeuerneG =| iIingGicates tne cassecd inteaer x Ss not 
equal to 2ero or one. 





ftoa ‘ay 


NAME: 
ftoa = comverts real 


ernwOPSIS: 
| Teoalin)s 
firoet mn; 


DESCRIPTION: 


Clee 7 rtoa 


Suim@ers ato AoGl1 for cutout 


Womverts a floating DSoint number tc an ASCII code so 


that 1t may be cutout 
fae PpOoInt Aumber is 


Momtaeounovl(enRe The passed float= 
fy rs t GSonverted to the hoc. i i 


renresentation and tnen outout to the RAMTEK screen at 


Wmyewuser cgefinec COP. 


Allows vor om ly Pour Geyaiuts 


eT € Gui the decimal clace and eiacht aigits jleft of 


the decimal! olace. 


BMAGHOSTICS: 
none 


See ALSO: 
data() , itoat() 
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gle c f faye 21 1977 get f 


NAME: 
- gett = read floating point number from RAMTEK keyboard 


ey NOPSIS: 
getf() 


MeoCRIPTICN: 
; Returns a floatina point numrher from the RAMTEK key= 
Board. [ve won lye Giumbers recogmized are: an ootionée|l 
TUS mS TormeTallOnes bY a strina of 2) CPIeS slice overeat a) 
containing one cecimal!l point, then followed cotionally 
by the letter ‘e’ followeo by a Signed integer. 


Normal return 18s the floating point number. 


fee ALSO: 
aqetnum(), retchar() 





get Mayverel 19/7 
NAMES: 

geti = return an integer 
eyNOPSIS: 

geti(l); 


DESCRIPTION: 


Returns am integer value from 


ASCII characters between 0 and 9 , 
recoanizea,y al! otners are 
eiace returm the orocess Seqins, 


denotes end of strina. 


SrEeaGNUSIICS: 
none 


eee ALSO: 


atoi() - retchar() 


entio Fed. 


get) 


from the RAMTEK 


Ene RATER Kevooard . 
Pre Wes Ve liy © 4 he 
HoCm “Lyol\ngd a cars 


hence carriage return 





getnum May 21 i977 qetnum 


NAME? 
getnum - read number from RAMTEK keyboard 


SYNCPSIS?: 
— getnum(base) 
Int base, 


BESCRIPTION: 
VeraseecmcCes itive or meqcative twmteqer number from the 
RAMIEK keyooard. Numerals tyced up to a comma or ac/r 


on the keyboard are consicered to be the number. Tne 
routine will not return Ave sie sume | lad Cs ef. OF .4 
Gomme 1S tvoedc, nor wil] ir aeCcen t Emaracte rs etrwer 


trom C#1aits from 2ero to nine when oase is equal to 
Gene oG sG1e1ts from zero to seven In case enn tase 
e1r1ant. 


base 1s the base of the Integer number returned. 1s 
Vsairestmrocted te eront foctal) or ten (decimal). 


Normal return 18 the jinteaer numner. 
MeeGNOSTICS: 
All errors are tnoicatea by negative returned values. 


Tne error values ana their meanings are as follows: 


= Inaicates a c/r was struck without any orevious 
enteres. 


ll a Ingicates the cassed oOarameter base was not equal 
fC ejont cr ten. 


mee ALSO: 
pecchor(), aqet f(} 


He ff 





getsw May el 1977 aetsw 


NAME: 
Memdetacw =) Get the mumber of es selectedq logical switch 


SYNOPSIS: 
gqetsw(), 


PeockiIPTIONs: 
Memietermines 1 the User hes Selecteq a valid loaical 
seemeom the Vector General tanolet. If sor it returns 
tme murmber of tnat switch. 


DIAGNOSTICS: 
Recurmed =! Imcicates invalid selection. 


See ALSO: 
plmiGis is 'S1xoak(), tadsa(); 


eve 





getxy 


NAME: 


tay mel 1977 getxy 


Bewxvee Getex,y GCoorginates Of a DOINt on the tablet 


mY NOPSIS: 


getxy(p) 
Tet. Oo; 
extern float tx,ty, 


DESCRIPTION: 


eeadsrcimto alotal variables tx and ty) the x,y coor- 
dinate values from tne tablet at the ocoint defired by 
Mane sttO.or tne stylus. If the parareter ‘o' 1S a, ols 
the stylus must be deoressed on the tablet surface to 
Select a ooint;, if ‘s' 1s a 0, the coordinates nearest 
wine. f10 of the cen are read. these coordinates are 
SOieomat heaily  COnNVerfred to virtua! tadlet coordinates 
of the tablet nas heen redirensionead (hy a orior call 


Gort saO0Gim ). 


lo? 





index May el 1977 index 

NAME 3 
index ~ select indexing 

SYNOPSIS: 
1ndexlCi;,xry) 
Picoate<, Yr 
int 17 

MealCRIPIIUNs: 
Miameccu@als zene, Jedexima iS Ceselected anqag the ine 
ex igor lac 8 1m Ehe control moce 1s turnea off. the 
index reaisters are tnen loageo with zero. 
lf 1 equals one, inaexina is selected ana the ingexing 
Mmescuheethe control mode 1S turned>on. The ingex re- 
qgisters are tren toaded witn tne disolacements passed 
In Maier ys x 18 loadeag in the xetindex (element) ree 
mister amd y is !oaded in the y~-index (Cline) register. 
~ nNuUSt be No aqreater than tne usert~aefined screen 
1) Ho) eae y must be no greater than the userwdefinead 
screen netaht. 
Normal return 1§ 27efro. 


PeeCHiOSTICS: 


All errors are indicated oy neqative returned values. 

The error values ana their meanings are as follows? 

=] Inagicates tne oassed integer i 18s mot equal fs0 
Zero or one. 

=2 iMiiitGaeoomemenor Whe maessea disolacements x and y 
ismoGea2tar tihan tne screen width or heianht. 

See ALSO: 
Screen() 


leat 





inter Weavrecl 1977/7 inter 


NAME $ 
“ce “Vrtemactive eolor table todification routine 


SYNOPSIS: 
inter() 


BeolriP{ION: 

Microw ancGerUnms a tUutorial rogram that enables the 
user to looxw at, select and nodify color tacltes during 
erogram execution. Frere are two Oasic modes in which 
the routine cperates. Seve iy fon these modes has a 
series of Commands whicn the user can execute. 


Poe eacoincm eoe. VWpOn execution the oaging mode is 
immediately anterea ira al a set of iaistepuet 1 Ooms 1S 
S1vspo layed. Thre followinaq commands are then accept 
able: 

Geemimai1cates a oarticular table number 15 ee, be 
disolayed. The numoder must then be entered 
between zero and seventeen. 

m = Increments table number displayea by one. 

b= Decrements tao0le mumber disoclayed by ore. 

im > spay Ss rast ruct 1tOMs . 


Qq = Guits from the interactive routine. 


ee= Enters the G@iik mode. 


er. Eott Moge. viem the edit mode 1S entered, a set 
Seeeracuruet ,Ooms 1s Giselavec listing the commands that 
Gam Oe 1SSued snd the ecit method they initiate. The 


commands are: 


t = Enters table assignment method. Permits en- 
Tfvves fom “snyvy taole to Se cocied ints the 
table desianatea by the user. The taole 
numoer which is to receive tne copied en- 
tries must oe entered first. 


0 ~ Enters octal assignment method. FntriesS are 
specified in 3a designated taodle ty entering 
the ordered triole that aefines the color 
gesired. The table number (417) In whicn 
the entries are to ve defined must re en- 


_— 
“ 
— 





tered first. 


c - Enters combining assignment method. teas 
methoac allows ere user to, logically OR two 
seoarate color lockuo table entries into a 
Selected user table entry. “hole tables may 
also te combined into a selected user table. 
The user tadle number (4-17) must be entered 
fer Sit. 


f - Enters inverting tables method. This method 
inverts the user taodle designated by the 
user. Entry zero vecomes fifteen, entry one 
becomes fourteen, etc. The act of entering 
the user tadle number executes the invere- 
SairoMire 


Geseaters Ccoovina tao leswnethod - After entry of 
the user table number that 18 to receive a 
Gemrec table the mumoer of the table tore ce 


coo1ed is enterec. ine vac tos Wenterinc tive 
Seconc taole number causes the copy to take 
Oltsce. 


Baom ent trys Lae egifing Methoas disoleay a tist of in= 
Structions on how the mnetnod 18 to be used and the 
resultS obtainec. Each of the metnoas have commanas 
that may be issued. The leaal commanaos for eEacn eait 
methoc are Summarized below. 


- Table Assignment Method. 

nm = [ndicates the table number ano entry 
Hence CoerTed follows. 

c/r=I[ncrements through the entries 
in the receiving user table. 

© - Displays tne color lookus table be- 
modified. [euieeturm= Tror cre 15> 
Slay, t¥eCe das 

Spee wOtGmoage< sto eq)’ t mode mwastructions. 


- Uctal Assiqnment Method. 

m = Inoicates the octal trinle to ve en- 
tered as the entry follows. 

e7Pp=-InerementsS tnrouch the entries 
in the receiving user table. 

See wlnsellovs the color lookuco table be- 
ing mendified. TOoeretumm from the 
display, tyne aq. 

Ceres Doce to eGift wmode instructions. 


Lie 





~Comolmi na cssoianment Method. 

nm = [ndicates the two ordered pairs 
cesianatgng the table mumber ana 
entry number to be ORd are to fole 
lenis ; 

c/r-Increments throuach the entries in 
ENemreCelVima user table. 

Se-  OSOlawoethNewGolor |ookuUD table 
Celina moditied. Te SFeturm trom 
the aisplay, tyoe a q. 

w = [rdicates two whole tables are to 
be ccombinead (ORd) ano their nume 
bers are to follow. 

Geewsuyts OCacce to eolt mode instructions. 


= Invertinac Tables Method. 
om = Disolays tne color lookuo tacle that 
1s being or was Inverted. 
a - Guits oack to edit moae insStructions. 


= Copyina Tahlies Method. 


PU eTSGOloavs the receiving taole. 
Seo uits back Fo edit moge imnstructions. 
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itoal Mavere 1) 19% / 1toal 


NAME 3 
mesos 8= ecomverts jmteqers to ASCII for outoeut 


mrNOPSIS: 
feoatlin) + 
Vale are 


MeoCRIPTION: 
Itoal takes an integer value anc converts iit to an 


Eel meGoOed scNaracter String, Having converted the 
value it 18 then disolayea at the user cefined COP. 


PPAGNOSIICS:? 
-  -NnONe 


eer ALSU: 
Peoat) 4 datal() 


= 
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ie tr wavemel Lo 7 


NAME : 
F Veer = cGisolay sinalé character 


er NOPSIS: 
mtr cen, Ss 1 ze ) 
imc ens, $1267 


Me oCRIPTION: 
Meevaiimei1solay the character cassecd 


eG ise wy, the CUrrFeENt coeret 1 


Mt 


with the $12ze ingio 
Gomeocwoat "time Current ooerating point. 


nis) teem niga 


1s an tne 


same line and seven AG tu | Screen elements to the 


Premteor jts “ast OOSI1tioOn. 


emecomtains tre ASCII code for th 


displaved, Ore tie secttial character enclosed 


GuQtcesS « 


iimsize 1S equal to one, the character 


Standardq size. 


lf$1z2 1s equal to two, the character 


SoOuoO |e wiotn size. 


line momperati1on 1S Iimaeccencent of any mode 


character to be 


in single 


jee Sol ay¥eq nim 


VSO l so layed. la 


issued orevisc 


Seclyen put YS sensitive to the flags acpoliceable to Al- 


mohanumeric mode. 


Normal return 1S zero. 


PeeeGNOSTICS: 


Returneg “1 indicates the oassea integer $size was not 


Saiial te. one or two. 


SEE ALSO: 
Seroure@), Gdoatat()> sizel)s index); 


i de 


pcmnd « )> 


writcon() 


a ie 





eut Mayveel 1977 eat 


NAME 3 
eure outoutsS SSCIY “enaracters to the FAMTEK 


SeNOPSIS: 
Sue Ce hi) + 


BeolRIPTION: 
' Echos the passec ASCII codeo character ta the RAMTEK 
Screen. tes Ge ses then incremented: to the Piaght ts 
prevent overwritina. 


ye@1real cali: 


out ¢46 )> 


PeaGNOSTICS: 
none 


SEE ALSU: 
sume)  lttrt) » retcrar(} 





Sick Mey elo? / Dick 


NAME: 
j pick ~ output an integer ovetween zero and seventeen 


SYNOPSIS: 
Sekt) ); 


eye 1? 


MeseRlPTIOn: 

Meutoutrs an intecer to tne RANTEK screen (between 0 and 
17) aenending entirely upon tne oassed oarameter. Ine 
PEexrolesour userul im diselavs tmvolivinga color table 
manirouletion. 


PaGNOSTICS: 
none 


eee AL SU: 
data) 
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Bath May el 1977 


NAME: 
Siotne= Dlet data as a histogram 


srNOPSIS: 
ploth(x,y-n,bdase) 
float *x, *yr, bases 
int ne 


BeocRIPriun: 


Pinemvalwes  yli! are treated as functions of x{i}. 


olotn 


As 


the fuMetION jcueEGllot tog, athens area oetween the curve 
and the x7axis, as desiaqnated ny base, 1s fic Vea sin 


with the color last selected. 


That ocortion of the histogram tnat lies on the 
Zl oe Clotted. 


The operation 1s totally independent eng any 
mode issued oreviously. 


x and y are nointers to linear arrays. 
MmaScmune Mumecer of DOoInMntsS to be olotted. 


Normal return 1s zero. 


PeAGNOSTICS: 
All errors are indicated ny negative returned 


SC Treen 


COnmttol 


values. 


The error values and their meanings are as follows: 


Feturnea -1 indicates the oasseqd carameter base 
on the userwacefined screen. 


Pee oUS plotin(), olotetr() 
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plotlin 


NAME 3 


el Ovmeclael 7 7 7 


Sileotlla = O1ot Gata with connecteoso lines 


erviorPsls: 


BESCR I 


So tilml x, VY rn) 
fle@at <x, XV 
at Aly 


Be reruls 2 


Maemvalues yilti are treated as 


the (umes Von il cameo tot tod, 


PemGt looms “Ot 


enliven eile 


ae As 


the successive points are 


eemmecteo BY Straiadmt lines of the color 


[SO 


mit eeOrtilomeat the Olotted curve which 


screen will be plotted. 


The operation 1s totally inaependent of 


mMOoae 1sSUeq0 Dreviously. 


xX And v are pointers to linear arrays. 
Nm is the numoer of points to be plottea. 


wee ALSU: 


Selotmcys, oOlbotot () 
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plotot avec 77 


NAME 2 
Bile Oote= plot data wth soints 


SYNOPSIS: 
olotot(xsrv,n) 
float *xs, *yer 
ime Me 


MeocmirP il lon: 
Pemiigeeve wes of yi! gra treated as finctions 
tweet o's Olottem with dots for each (x 
Coordinate. Premeets .2re im tne color last 3s 


If 9 ooI1nt does not Ji: on the yuserrdefined 3 
WoernG tao ot led < 


[ipenoceratiom 1S totally independent 0 f anv 
noGe  Tssueqd oOrevious!y. 


Moanomey Sore SO1mters to Jinear arrays. 
mS the mumoer Of OCOINts toe be olotted. 


See ALSU: 
euortnc) s,s Clotin() 


18. 


Oulkee oit 


O f de bs | 
ery 
elected. 


COMt to. 





Boint May el 1977 o01nt 


NAME? 
Soimt = Cerine Dont 


eyNUPSIS: 
point(x,y) 
float XK, ys 


MeolcRiPrTion: 
Defines a DoINt on the virtut] screen. [He  poimt must 
Pioww hE nt Ae tne uSeErR=adefined Screen. 


[Tf in Graohic Vector mode, («,y) defines the endpoint 
of a vector ang esuses at to “be drawn. The current 
Oeceratina eCoint 1S then (x,y). 


Meowlnememeriraonhic sarteésian nede, (x¥,v)} defines the 
Siaqormalt’y “o@po0sit4 corner (Cfror the COP) of a oro=- 
cosed rectanale. Tne rectanale thus defined 1s snaded 
Wmecineocurremt ty selected color. Ihe cuurent omerating 
Boint- 1s then (x;y). 


If in the Graohic Elsrent mode, (xry) defines a single 
Boimt OM tne user-dr fined screen ana causes 2 dot to 
be drawn there. bie wcurremt Op frating cont 1s then 
(xry). 


NGrmai return 1s zero. 


PPacGNOSTIts: 
Vwurmmeocm—timatrecates tre OSssec point coes not Jie on 
the userw-definec screen. 


See ALSO: 
Strtxy() 
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pointer May 21 1977 pointer 


NAME: 
. Source = oefine a DOImt ralative 


SruPsis: 
SOQintret( x,y) 
float Xr Yo 


DESCRIPIIuh: 
Defines a coint on the user-defined screen relative to 
Piomlast a GurRmreEmMt Opemating OSiImt « 


if 1m GReemaic Yector mode y Vector 1 Cot the last 
SUGHOMEMG@SerotImMa DOINt CO a GOint definec oy the last 
Supreme mooermatyma OOImt Slus the displacements x and y 
1$ Orawn. 


It Ane enewbraoni ie Cartesian noce, a rectanale is de- 
DiCect over tne: CURrem@: OOFRaLINa DOINtE and the point 
Gommureogmny Ssaqqiqg x a1d y to 7'e COP. This rectangle 
momo SO wavegd Pin. the eCerrent colcr. 


Po fraorcsoaic clement mode a dot is Grawn at a OOvimt 
Geoemugeqmeoy the lest currant oO ratina soint olus the 
Gisolacements x and v. 

wie ys jlert at the calculeatec ib@ocat liom. 


See ALSU: 
Sut <y ©) 


Wish 





ramtek Mawees ao 9/7 / ramtek 


NAME ¢ 
Pamtek = initiates RAMTEK system 


SYNOPSIS: 
Ramee k ( ) 


PESOCRIPIIOUON: 
Mantiates the RAMTEK systet ana sets tne aefault con- 
eaters aSe tol lows: 


Dinca Ze the UWsec= i fimed screen to 0.0 to 
MOO 3m < and y. 

Ce = tLoeds a shades of arey color table (0) in the 

Aiea ns 

“MENSeCecrSsecolor Tifteen tn taole zero for display. 

- Selects Alonhanumeric control mode. 

Oeepocemew-4@ En for Feeding amd writing. 

- krases the screen. 


ow Ww 
ud 


NORmMoe ls PetURM 1S zero. 


PeaGNOSTICS: 
Returnea o-] lmeceores URa™’ TER device coula not tbe 
opened. 


ess 





redim 


NAME 3 


Mayer 1977 redim 


redim 7 redinension the values reéd from the tablet 


ariverolsS: 


eecim tl); 


extern tloat tx,ty? 


PeoCRIPT ION: 


Fedimensions or converts the curreit x,y coordinates 
Pes@moye Getxy ~to virtua! tablet crorcinates. This is 
apolicapble after the routine “tabair" hes been used to 
redimension the virtual taodlet to a userv-defined $128. 
Tne converted coortinate values are olaced in gloval 
variaoles t x and tv. No oOarameters are passed either 
Have oye tris se func t }oO 9. 


mee 4LS0: 


getxv(); 





mesc |r 


NAME 3 
resclir =- 


eeoVUPSIS: 
mescin( ) 


Mavere tl 977 rece |r 


restore the user's color tables to the system 


© 
7 


Gharee«saveol; 


extern co 


MeacrRiP | (IU: 
Tne user’ 
into the 
must nave 


omer ie, 


SERVenavom) O78 the es )or ranles are “brought 
Suse TOcdeamuser falesc al led “saveol" which 
been created by 2a orior czl1!1 to savelr( ). 


Morma | return aS the numner o f bytes re3aq from 


—saveo) 


Mao NOSTICS: 
Returned 
tne file 
Returned 
Psoveol 


See ALSO: 
savcelir( ) 


mom -Colortol tit) “(Sshoula pe 448). 


“—tinopeates on wesuccessful attempt to ~ooen 
eSaveol s 

=o l@cdiecates an. error Ya reading trom 
momece tort o|! ) kl 


eS 





restat May el 1977 restat 


NAME 3: 
restat - restore the RAMTEK Cane VG Tablet) to oprevieg 


ous status 


SYNOPSIS: 
Pasta 


MmeouRNLPILON:; 
Dmemcomtnhour Status that was im egfect at the time of 
Bifemisactrecaimi tec savstatt } 1S Festored to the RAMTEK., 
This includes moder control flags, color taole, and 
the dimensions of tne virtual Streen and virtual ta- 


ele t. 


eer ALSO: 
SV Start ( ) 
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retchar Maverce! 1977 retcnar 


NAME 3 
Retemar = fread g Character from RAMTEK keyboard 


eerngPSiS: 
retchar() 


DESCRIPTION: 
Mime l cede cepresenting the tyoed character is rem 
Cumpedeic¢ the lower half of an integer. 


SEE ALSO: 
qaetnum(), aetfl), getil) 


ital 





Savclr Wavere | 1977 Savclr 


NAMES 
svelte saye the current color tables 


SYNOPSIS: 
Savelr( ); 
enair saveoo)- 
Stern colortbi tl li; 


MeocniPlilJUN: 

' Tne current userrmavailaole color taoles (4 = 17) are 
Saved into a newlytcreated file called "savcol” in thre 
user's directory. This tile may Suosequently oe re- 
opened and reads cack ‘al ete) the system cy a call to 
resciIr( ). Tnis allows the user to preserve desirea 
color scnemes netween sessions. 

Normal Return 1S the number of oytes reac ieee 
Psaveo! e-==  (shculd be 4438). 


DIAGNUSTICS: 


Returned °o1 inet eates sean seunsuceoss fu | attemot to 
Gaeoavommmem file '“saveo)]"- 
Pet@rnea =2 indicates an error in writine to SAC OAL 


me meecouror to) l} . 


pee ALSO: 
resceilrt .) 


roe 





mesavstal 


NAME: 


May cl Slaw’ Savstat 


Savstat - Save the status of the RAMTEK disclav 


SYNOPSIS: 


Savectat( ) > 


DESCRIPTIUN: 


The current control status of the RAMTEK and VECTOR 
GENcRAL Tablet is saved for subsequent use. This data 
WiasticGescwehommec], —comtrol flags, current color table, 
Soe VemeGimensiloms. of the virtual screen and virtual 


tao et. 


ee ALSU: 


Restat« °) 
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Screen Mayecl 19/7 screen 


NAME: 
~  gereen = define user screen 


SYNUPSIS: 
mereenmixiapvilsxepye) 
float lp yap ees (Ye? 


ReoCRIPT LION: 
mete somastandara cartesian coordinate system of any 
Scale for tne user. (Wemooimteuxtyy il) becomes t 24 
coordinate of tne lower left Gorme fire tot tne screen. 
Ime NeOOlmMun(xc,yc) becomes the coordinate of the uscper 
PiUVemGoememIrotT Che screen. 


ViemMiIct woecmotrictly !ess than xed. 
Vo oMUsumoemstrretly less tham ve. 


All subsequent user coordinates Zia interoreted ac 
GCocadimantortnis user-defined screen. 


Normal return 1S zero. 
PPASNOSIICS: 
moet simaicates x! is mot tess than xe of yl is 


not less than yew An error message is also cCrinted on 
the terminal screen. 


1990 





Sere! | May el 1977 Semele 


NAME 3 
™ scro!] - scroll screen 


SYNOPSIS: 
SenorhGcarcmt ) 
enar™ ay 
freat “cmt, 


DESCRIPTIUN: 


Tne current GIvsolayed' s1¢6erure ~ on tne screen is 
scrolled uo or cown. lmntormation Scrolied off the too 
of tne screen wil) pe scrollea mn tne net com and 


VIiGeC=VeErSa. 


i wanes te memaracter Gd, tn@® direction of tne scroll 
wa lt ‘pe conn. 


i vo cmmemenoaracter "“U', the direction of the scroll} 
will be we. 


cnt 18s the number of usersdefined veunits Clines) that 
ene oewtne VS to be scrolled. “¢nt can be no larger 
Diane tmemvirtuUal screen nheignt. 


Normal return is zero. 
OLAGNOSIICS: 
Ail @rroers are indicateao bv necative returned values. 


The error values ana their meanings are as follows: 


~-| Par@iireates tne DWassed Oarameter ent was less thom 
ZErFo Of Greater tnan the screen heiaqnet. 


-c tmeieates the woassead Oagrameter a was not a 


Te 


oe 





setmode Mayveael  l977 setmocde 
NAME: 
setmode - select control mode 
SyNorSsIS: 
setmode(a,bd) 
ine ar DOD, 
MescCRIPTIUN: 
Selects the control moae “according to tne cassed 
Oarameters 3a ando. a reoresents the control mode as 
follows: 
0 = Alphanumeric 
1 ~ Transverse Data 
ec =~ Raster Data 
3 = Comolex Data 
4 = Grandhic Vector 
See occaonic Fiot 
o - Graonic Cartesian 
7 = Graonic clemrent 
All flags are turned off if 6b is equal to zero. Lis 50 
1s equal to one, anv flaas set in the orevious mode 
are 3a!so set with tne mode selected ny a. 2 ||, entis 
ties disolayed suoseaquent to this call are disolayed 
according to the selected rode. Routines that disreo 
gQara the selected node are axis), olock(), inter(), 
Pte onmernt(), Olotint), olotot(), textol)+ and vec- 
tor). 
NOortoliereturn iS zero. 


MexGNGSTICS: 
All errors are 
The error values and their 


-| Peavecates the cassed 
zero or greater than 
-2 Indicates the oassed 
zero or one. 
See ALSO: 
Eomee cGy sok emal), acolwida 


writon() 


oe 


indicated oy negative 


returned values. 
meanings are as follows: 


parameter a ~as less than 


Sevens 


Sagcaneter 5b Was mot ecual to 


lye tyx<otl) sy. amaex()» 





SixDak May el i977 Sixpak 


NAME: 
Sixoak - select from sitx standard switches on tablet 


SYNOPSIS: 
sixoak«(); 


DEeSeRIPTION: 
Establishes a package of six selection boxes or 
Switches an tne Vector, General tablet (Caccordina to 
Temoltate i) and returns the numoer of the Switch 
selected ov tre user with the stylus. 


PeSGNOSTICS: 
Normal return 18 the number of the sSwitcn selected 
(1-6). 
Returned =<! indicates invalid selection. 


mime 4LSO: 
Duildsw(); aetswl)? tabsw(); 


Tos 





size Mayere 1 7 7 size 


NAME: 
size - select letter 


ey NUPSIS: 
size(r) 
Voce fs 


BesuriPlION: 


size 


Caras “calemto lone the stamdarad character size ies 


USEeC. 


iinet Ss. eaual to. Ewo 
1s used. 


the double width character $12e 


Setsceunmenw = aouole with flaq in the contro! mode. 
Therefore $1z@ takes the same action as dblwiall). 


Normal return 18 2e¢fr0. 


BreeGNOSTICS: 


Pawnee cde=ferndicates tha oassed oarameter -r ioe 


Satiatcanone of CwoO. 


eee ALSO: 
Golwirdt), strout () >, 


eve fe), 
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Senout May 21 1977 Stireut 


NAME 3 
Herour = OUGoOuUt character string 


SYNOPSIS: 
strout(so) 
Cnar *so; 


Mesck [Pl LON: 
Oiteuescmoarenaracter String no greater than 100 eharac- 
SefS FOmag sDeGinnina at the current onoerating ooint and 
CONtINUINGE on tne same line. After comoletionsr an aun 
fSomacie line feed occurs which defines a new current 
operating ooint on the next line at the Same starting 
Bont aS TERe OrevilousS jine. 


Soe oo Welw omit te character Strina to pe sutout. 
Normal return 1S 28fr0. 
MPA GNOSTICS: 
Returned -1 indicates the string contained more than 


100 Ginmaoroct er Ss « In thet omease no wenaracters wi lio be 
Ai So aved. 


See ALSO: 
Mata lyesizet), lttr()> texto () 


Js a 
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Smt cy Mave v7 / Stim tay 


NAME? 
Smmuxy = ESteaolish Current operating point 


evcresis: 
Strtxyl(x,-y) 
PioOat <5 ys 


MeocrlIPTIGN; 
EotoatiSmes me CUrRPeNt OOoerating oco’nt on the Screen 
for suosequent Has © SUG. ons. tiwivemcurreatamoge: 1S 
Graonic Vector with the fixed point flag set, 1€¢ es- 
taodiishes tne pase from which the vectors are drawn. 


Wars Seuscer=metimea Screen |ocati im Im x 
¥V 18S 4 uSers=defined screen tocationr in y. 


(xr,y) nust lie within the user-defined screen. 


Normal return 18 zero. 


PreGciOsSTtiIcs: 
Vorupiecmmee mimo 1ecates (x,y) does not lie on the wuser= 
defined screen. 


See ALSU: 
(econ Screen(), ooint |} 


Eos 





symbo |] May el 1977 symbol 


NAME $ 
Symcol = disolay a snecial svrbol 


SYNOPSIS: 
sympol(sy); 
int sylol]; 


MeocRiPTILONs 
Draws the symnool that has veen defined by tne wsers 
Thus Chew wwser may cefine special symools to augment 
Ene stamoara ACSI] craracter set. Requires the pointer 
Sy to the user-defined array. This routine automati- 
cally outouts Ile ovtes in the Transvoirse Data mode. 


CYouGealegdarca Ceclaration: 
tiesto mal! (00GC0000, 0000082, 
VOSeete, VOSeUCe, 
00090000,00090000}; 


ty 2 te aiepc.o | ls 
meee a lomo ics 50.07 50. 073 


eee ALS: 
Eadat 4) 


We) il 





tasecolor 


NAME? 


Eaecoior = tanlet 


SYNOPSIS: 
@ooec lor), 


PE SeRIPT LON: 


Wigayvuee le i977 


GolorR mManioulatton 





tabcolor 


fore elon 


MmOns Tor mucne “interactive Todification of color 
tables via tre VECTOR GENEF4L TABLET. Tne systen 
Ceomeotcentor  eequired inoutsS fror the taclet. A teme 
Sare TOG tme tanlet is required for inout. The tatlet 
Timo mM Mm sl 1zea Mrior (auc. |line tebocolor (see ta- 
SO Vt. 
vse es 1 t 
Catrmad tC) F 
CebGcolrorl); 
Temolate Descriotion 
MPESGNOSTICS: 
Ugieeeasetive to the ROMTEK oie sccéess terminal. 
eee ALSO: 
MVem@mnsavcolor() |», resa'’rt) » ennce() ,» color) 


Gourert ©). 


fab t ©) 
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tabdim Mave i ok 7 e tabdim 


NAME: 
PooGin = fFedimenmsion the virtue! teclet 


SYNOPSIS? 
tHabolir(x«Nax,xXmMinrsymax-yvmir ) 
douonle xmax,xminsyvynmaxyvmir; 


Mesc=]PT ION: 
Me@eceots aSwoaraTetecS a Weximum anc Tininum value 


rne Cesc meunenSiOns (1m that croaer) and ‘sets 


Bao oe Oomeneceo mad) remsioms. Alilor the user no 


tor 
tne 
V1ew 


tne Vitus! Mae lec | dem. S1ze Fetrtern. that conforms 
Howttme Stomecns Cartesian i qric (TIMimuUnMm xs,y values 


reoresenteds act the lower eat t corner; maximum 


values located at the upoer riagnt corner). 


els, 


Keepy 





aon ¢t Mayveei 197 / tabinit 


NAME 3 
waormyt = oDen the tanlet for the user 


erNoPSIS: 
alone (7 


MeocCRIPTLON: 
Coens the Vectcr General tabdlrt and establishes user 


access” v123 file-pornter for. Sets the maximum number 
Src alecaleowtteches ovailanclB to cS. Prints an errcoe 
message if unadle to open tse device. 
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taodsw 


NAME: 


Mayee lL ler 7 tadsw 


taCsw = interactively defire switches on the tablet 


SrtioPS({s: 


tabsw(sw) 
int Swe 


feoek iP] LON: 


Allows the user to define 3 set of logical switches on 
tne tablet Svauri ti z2int the Styl. S$ >to *select tne low 
Set onmmeCOOReatNates, tne. the hiqn set Ot eOonrcdiwnotes 
Cie, the lower ett “soOfmer Ot tne cesireq selection 
Note emeaMOmUC@er £:iGkt Gorme* of the box). tre 
aUlileveepe | teh. Switches to be defined 18 Indicated by the 
parameter ‘'sw'. The switches are numoered seauentially 
as thev are defined. 

Frints the x,y values as seleiteds alona with the 
Switcn ‘number assianec after each selection orecess. 


See ALSO: 


SUmLOGwiis  qetswl)s Ssixoak(), 
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rexto Ma Vvarc lato? 7 


DEAE -° 
mextonr- GisOlavy a Olock of tet 


SYNOPSIS: 
MemtourxtE,ctaorcols+s2swo); 
lmao ec tao,cOlrSZrwor 
Grertertxtl J 4 a 


meocriPTION: 


The multtole-entry array of variable 


leerey Ein 


texto 


cnaracter 


Seana s eieressed cy A4txt is aisclayed on the RAMTEK 


AeCOGGIMamto tme Ootherooparameters : 


ctab => desirad colai table number 


Golee=- COlOrf entry “rom that 
Sze owoesi fed Chata ter $i ze 


taole 


Or <<) 


wo => | if adaitive trite 1s desired, 


Moeme | return 3S Zero 


PXAGNOSTICS: 


Of. “met 


Returned -1 indicates one of the character strings 15 


Coon logemrover 101) characters). 


JJ(Eclemvwmesrrines over 9Yl-characters 
* the screen cn the sane 


wea around 


Ol 


mn lenath will 


line. 





tolwho Povee polos / tolwho 


NAME ¢ 
Bonnom= request tor ¢cuerenmt colir table number 


eaNUPSIS: 
Golewro () 


DESCRIPTION: 
Returns eam imtreqer value wnhich 31s the table number of 
the @lehie on ¢ table tat MS. ecw r mene ly being used for 


displav. 
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tdata Migvy sel Lo7] 


NAME: 
Maactwases CULDUtS transverse arta for the user 


eS, fO0PSIS: 
ease ksd, Oy; %7¥) 
letersi y 
imi. OY » 
float xXsryvy-r 


Peocr(PliuNn: 


The variable tra is the name of an array containing 


the transverse data definition for the image. 
the number of tytes to be passed ; x , y are 
Starting SBoIintrs ele the desired disclay. 


CPoncverseuagote 1S Orocesied ovte by byte with 


byte neing aisnolayec airertiv beneath tre last one. 


Evoveoleeoata declaret ion: 
Wome ilove |! {00000 10,0000042, 
UUSe22707, OU Sede, 
09000)0,9000000}; 


PVyolrea lca] )): 
Meee Galona, le, os, 50.0); 


Pm ineaetonmcayil motloremit moving off of the 


as Memeo s tO the mi int on] Oyte ang renositions tre 


user selected y value 3nd continues. : 


SeAGNOSTICS: 
none 


eee ALSO: 
setmode() , symbol () 


20d 





terse Mayvere | 1977 terse 


NAME? 
terse = selectively erases the screen 


SYNOPSIS: 
terse(era,verb,erc,erd), 
float era,verodverc,erd: 


Meoe rl PT ION: 
Allows tne user to selectively erase a nortion of the 
screen ov o38S1NgQ the coordinates of two onrosite 
corners of a box. The arsa within tne gefinesd vox wil) 
SBemoogtmtea fo the Sackaround color. 


BeeeGNOSTICS: 
none 


SEE ALSO: 
Sertxy mmc ornmt() », setmodet) ;-; bloce() 


21005, 





eine ie May el 


NAME: 
te toe 


Goce calor “from 


SYNUPSIS: 
@rroLre(G,a,r) 
mc Da, fs 


Pesce iPTION: 
The three inout farameter 
ries of bluelo), green(a) 
inteaer wnich is suitable 
ba0le entry. 


1977 Ce lke 


three-number triple 


S representing the lemtienmst = 
and fedtlr) are codqed into an 
fOr tASerrion into A Color 


ScmoOecteeem lemand Lo anc. represents the intensity of 

blue desirea. 

SrseTe eve enm) ana Lo and reoOresents the intensity of 

Qreen desired. 

S is between 0 and 15 and represents tne intensity OF 

Peaq cesi fed. 

MeGme return +S am integer representing the code. 
PeAGNOSTICS: 

VoeUnRmecm= lh TMOlGCates Anout, Oaraeneters bob, a or rare 


MeGetive or Gqreater then 


See ALSO: 


CHme@ eye carth! () 


CU6b 
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vector Maver oT 7 


NAME: 
vector = draw single vector 


SYNOPSIS: 
Vecuor(xl,ylsxcryc) 
fieat ecl, yi, xc, Yer 


MeockiPl lon: 


A vector 18 drawn On the Sereen from 


VEC Lor 


user~aefined 


Screen ccortinate Cy yale) to Gvew ve). The current 


Geeratimec ocol1mte 01s left st (x2yve). 


Tne operation 1s ingeoendent of any mode 


1Ssuea erevie 


ously but 18 sensitive to the flaas aopplicable to the 
GReenicevector control mode. Unogesired results may be 
ootainea Mmammene fixQt thaaG 3s SeG crevious to calling 


Wee vor Ga. 


Normal return 1s 2¢Pr0. 


DIAGNOSTICS: 
VocUpmeoGm= te iniicates No Ccortionm of the 
lies on tne user defined screen. 


SEE ALSO: 
Se rniG@weeaaiwicdt), fixptl), andcex €) 
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writon Mayre lla? 7 weit on 


NAME: 
wereonm = oedaqrtive write 


SYNOPSIS: 
writon(w) 
Int we 


Meocr iP rian; 
Mims oe tome see adcaitryve werte flag im the -contro! 
mode 1s BUemoGnwOn Cassine Subsequent entities in 4l-= 
Onanumeric, Raster Data and Transverse Data mnoedes to 
Volo m=mOMumgao cl MOFEVIOUS Entities without destroying 


them. 


If w is a zero, tne additive write flag in the control 
Wee wlio mecuinae 1 eet tf « 


Normal reeseturn is zero. 
BIAGNOSTICS: 
Returned -l incgicates the oassea integer w is necative 


OF Ofreater tran one. 
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